@purveyors/cli 0.33.2 → 0.35.0

package/dist/commands/price-index.js

@@ -1,9 +1,11 @@
 import { Command } from 'commander';
 import { outputData } from '../lib/output.js';
 import { withErrorHandling, PrvrsError } from '../lib/errors.js';
-import { createParchmentClient, unwrapParchment } from '../lib/parchment.js';
+import { createOptionalParchmentClient, createParchmentClient, unwrapParchment, } from '../lib/parchment.js';
 import { CLI_NUMERIC_BOUNDS } from '../lib/numeric-contracts.js';
 import { parseStrictPositiveCount } from '../lib/strict-number.js';
+const COMPARISONS_WHOLESALE = ['true', 'false', 'all'];
+const ORDERS = ['asc', 'desc'];
 function parsePositiveInt(rawValue, flag, max) {
     const parsed = parseStrictPositiveCount(rawValue, max);
     if (!Number.isFinite(parsed)) {
@@ -20,13 +22,148 @@ function parseWholesale(rawValue) {
         return 'false';
     throw new PrvrsError('INVALID_ARGUMENT', `Invalid --wholesale: "${rawValue}". Must be "true" or "false".`);
 }
+function parseEnum(rawValue, flag, values) {
+    const value = rawValue.trim().toLowerCase();
+    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;
+}
+function toFlag(attributeName) {
+    return `--${attributeName.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}`;
+}
+/**
+ * Resolve a `price-index <subcommand>` invocation's own options.
+ *
+ * The parent `price-index` command keeps its snapshot filters (`--origin`,
+ * `--from`, `--wholesale`, `--page`, `--limit`, ...), and Commander assigns a
+ * flag to the parent whenever both levels declare it. Subcommands therefore
+ * read their declared options from both levels and reject parent-only filters
+ * instead of silently ignoring them.
+ */
+function resolveSubcommandOptions(cmd) {
+    const own = new Set(cmd.options.map((option) => option.attributeName()));
+    const parentOptions = cmd.parent?.opts() ?? {};
+    for (const key of Object.keys(parentOptions)) {
+        if (!own.has(key)) {
+            throw new PrvrsError('INVALID_ARGUMENT', `${toFlag(key)} is not supported by \`purvey price-index ${cmd.name()}\`.`);
+        }
+    }
+    return { ...parentOptions, ...cmd.opts() };
+}
+function requireOption(opts, key, cmd) {
+    const value = opts[key];
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new PrvrsError('INVALID_ARGUMENT', `\`purvey price-index ${cmd.name()}\` requires ${toFlag(key)}.`);
+    }
+    return value;
+}
+function buildComparisonsCommand() {
+    return new Command('comparisons')
+        .description('Available exact 30-day matched price comparisons with significance')
+        .option('--wholesale <true|false|all>', 'Market scope (API default when omitted)')
+        .addHelpText('after', `
+Examples:
+  purvey price-index comparisons --pretty
+  purvey price-index comparisons --wholesale all --json
+
+Notes:
+  The API discovers origins with an exact 30-day matched comparison ending on the
+  latest completed observation day; an empty list means none qualify.
+  Each comparison carries its significance read verbatim. classification is null
+  until eight baseline windows exist, which means "not enough history", not "quiet".
+  Requires Parchment Intelligence access, enforced by the API.`)
+        .action(withErrorHandling(async (_opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        const opts = resolveSubcommandOptions(cmd);
+        const query = {};
+        if (opts.wholesale !== undefined)
+            query.wholesale = parseEnum(opts.wholesale, '--wholesale', COMPARISONS_WHOLESALE);
+        const client = await createParchmentClient('member');
+        const data = unwrapParchment(await client.priceIndex.comparisons(query), 'price-index comparisons');
+        outputData(data, globalOpts);
+    }));
+}
+function buildComparisonCommand() {
+    return new Command('comparison')
+        .description('Matched-listing price comparison for one origin between two exact dates')
+        .option('--origin <origin>', 'Origin to compare (required)')
+        .option('--from <date>', 'Starting UTC date, YYYY-MM-DD (required)')
+        .option('--to <date>', 'Ending UTC date, YYYY-MM-DD, within 365 days of --from (required)')
+        .option('--wholesale <true|false>', 'Market scope (API default when omitted)')
+        .addHelpText('after', `
+Examples:
+  purvey price-index comparison --origin "Ethiopia" --from 2026-08-31 --to 2026-09-30 --pretty
+  purvey price-index comparison --origin "Colombia" --from 2026-06-01 --to 2026-09-01 --wholesale true --json
+
+Notes:
+  Supplier-balanced fresh matched prices only; status "insufficient_fresh_coverage"
+  returns a null changePercent, never zero.
+  Requires Parchment Intelligence access, enforced by the API.`)
+        .action(withErrorHandling(async (_opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        const opts = resolveSubcommandOptions(cmd);
+        const query = {
+            origin: requireOption(opts, 'origin', cmd),
+            from: parseIsoDate(requireOption(opts, 'from', cmd), '--from'),
+            to: parseIsoDate(requireOption(opts, 'to', cmd), '--to'),
+        };
+        if (opts.wholesale !== undefined)
+            query.wholesale = parseWholesale(opts.wholesale);
+        const client = await createParchmentClient('member');
+        const data = unwrapParchment(await client.priceIndex.comparison(query), 'price-index comparison');
+        outputData(data, globalOpts);
+    }));
+}
+function buildHistoryCommand() {
+    const { priceIndexHistoryLimit, priceIndexHistoryWindowDays } = CLI_NUMERIC_BOUNDS;
+    return new Command('history')
+        .description('Tier-one price-index chart history (public up to 90 days)')
+        .option('--window-days <n>', `Trailing window in days (${priceIndexHistoryWindowDays.minimum}-${priceIndexHistoryWindowDays.maximum})`)
+        .option('--page <n>', '1-based page number')
+        .option('--limit <n>', `Results per page (${priceIndexHistoryLimit.minimum}-${priceIndexHistoryLimit.maximum})`)
+        .option('--order <asc|desc>', 'Snapshot ordering (API default asc)')
+        .addHelpText('after', `
+Examples:
+  purvey price-index history --pretty
+  purvey price-index history --window-days 30 --order desc --json
+  purvey price-index history --window-days 365 --limit 500 --json
+
+Notes:
+  Windows up to 90 days are public and run without credentials; 91-365 days
+  require Parchment Intelligence access, enforced by the API.`)
+        .action(withErrorHandling(async (_opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        const opts = resolveSubcommandOptions(cmd);
+        const query = {};
+        if (opts.windowDays !== undefined)
+            query.windowDays = parsePositiveInt(opts.windowDays, '--window-days', priceIndexHistoryWindowDays.maximum);
+        if (opts.page !== undefined)
+            query.page = parsePositiveInt(opts.page, '--page');
+        if (opts.limit !== undefined)
+            query.limit = parsePositiveInt(opts.limit, '--limit', priceIndexHistoryLimit.maximum);
+        if (opts.order !== undefined)
+            query.order = parseEnum(opts.order, '--order', ORDERS);
+        const client = await createOptionalParchmentClient();
+        const data = unwrapParchment(await client.priceIndex.history(query), 'price-index history');
+        outputData(data, globalOpts);
+    }));
+}
 /**
- * `purvey price-index` — Parchment Price Index aggregate snapshots.
- * Requires an authenticated session or API key with price-index entitlement.
+ * `purvey price-index` — Parchment Price Index reads.
+ * The bare command returns aggregate snapshots (price-index entitlement);
+ * subcommands expose matched comparisons (Parchment Intelligence) and chart
+ * history (public up to 90 days). Entitlements are enforced by the API.
  */
 export function buildPriceIndexCommand() {
     const priceIndex = new Command('price-index')
-        .description('Fetch Parchment Price Index aggregate snapshots (requires price-index access)')
+        .description('Parchment Price Index snapshots, matched comparisons, and chart history')
         .option('--origin <origin>', 'Filter by origin')
         .option('--process <method>', 'Filter by process method')
         .option('--grade <grade>', 'Filter by grade')
@@ -41,9 +178,12 @@ Examples:
   purvey price-index --origin "Ethiopia" --json
   purvey price-index --from 2026-01-01 --to 2026-06-30 --pretty
   purvey price-index --wholesale true --limit 25 --json
+  purvey price-index comparisons --pretty
+  purvey price-index history --window-days 30 --json
 
 Notes:
-  Requires a Purveyors session or API key with price-index (PPI) access.
+  The bare command returns aggregate snapshots and requires a Purveyors session or
+  API key with price-index (PPI) access.
   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();
@@ -69,6 +209,9 @@ Notes:
         const data = unwrapParchment(result, 'price-index');
         outputData(data, globalOpts);
     }));
+    priceIndex.addCommand(buildComparisonsCommand());
+    priceIndex.addCommand(buildComparisonCommand());
+    priceIndex.addCommand(buildHistoryCommand());
     return priceIndex;
 }
 //# sourceMappingURL=price-index.js.map

package/dist/commands/price-index.js.map

@@ -1 +1 @@
-{"version":3,"file":"price-index.js","sourceRoot":"","sources":["../../src/commands/price-index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"price-index.js","sourceRoot":"","sources":["../../src/commands/price-index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EACL,6BAA6B,EAC7B,qBAAqB,EACrB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAWnE,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAU,CAAC;AAChE,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAC;AAExC,SAAS,gBAAgB,CAAC,QAAgB,EAAE,IAAY,EAAE,GAAY;IACpE,MAAM,MAAM,GAAG,wBAAwB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAC,CAAC,oBAAoB,CAAC;QACnF,MAAM,IAAI,UAAU,CAClB,kBAAkB,EAClB,WAAW,IAAI,MAAM,QAAQ,cAAc,WAAW,GAAG,CAC1D,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB;IACtC,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACjD,IAAI,UAAU,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACzC,IAAI,UAAU,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IAC3C,MAAM,IAAI,UAAU,CAClB,kBAAkB,EAClB,yBAAyB,QAAQ,+BAA+B,CACjE,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAmB,QAAgB,EAAE,IAAY,EAAE,MAAoB;IACvF,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAK,MAA4B,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAU,CAAC;IACrE,MAAM,IAAI,UAAU,CAClB,kBAAkB,EAClB,WAAW,IAAI,MAAM,QAAQ,sBAAsB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACxE,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB,EAAE,IAAY;IAClD,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,UAAU,CAClB,kBAAkB,EAClB,WAAW,IAAI,MAAM,QAAQ,sCAAsC,CACpE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,MAAM,CAAC,aAAqB;IACnC,OAAO,KAAK,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC;AACxF,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,wBAAwB,CAAC,GAAY;IAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IACzE,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAE/C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,UAAU,CAClB,kBAAkB,EAClB,GAAG,MAAM,CAAC,GAAG,CAAC,6CAA6C,GAAG,CAAC,IAAI,EAAE,KAAK,CAC3E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,aAAa,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;AAC7C,CAAC;AAED,SAAS,aAAa,CAAC,IAA6B,EAAE,GAAW,EAAE,GAAY;IAC7E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,IAAI,UAAU,CAClB,kBAAkB,EAClB,wBAAwB,GAAG,CAAC,IAAI,EAAE,eAAe,MAAM,CAAC,GAAG,CAAC,GAAG,CAChE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,uBAAuB;IAC9B,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;SAC9B,WAAW,CAAC,oEAAoE,CAAC;SACjF,MAAM,CAAC,8BAA8B,EAAE,yCAAyC,CAAC;SACjF,WAAW,CACV,OAAO,EACP;;;;;;;;;;+DAUyD,CAC1D;SACA,MAAM,CACL,iBAAiB,CAAC,KAAK,EAAE,KAA8B,EAAE,GAAY,EAAE,EAAE;QACvE,MAAM,UAAU,GAAG,GAAG,CAAC,eAAe,EAAmB,CAAC;QAC1D,MAAM,IAAI,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;QAE3C,MAAM,KAAK,GAA0B,EAAE,CAAC;QACxC,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAC9B,KAAK,CAAC,SAAS,GAAG,SAAS,CACzB,IAAI,CAAC,SAAmB,EACxB,aAAa,EACb,qBAAqB,CACtB,CAAC;QAEJ,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,eAAe,CAC1B,MAAM,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,EAC1C,yBAAyB,CAC1B,CAAC;QACF,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/B,CAAC,CAAC,CACH,CAAC;AACN,CAAC;AAED,SAAS,sBAAsB;IAC7B,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;SAC7B,WAAW,CAAC,yEAAyE,CAAC;SACtF,MAAM,CAAC,mBAAmB,EAAE,8BAA8B,CAAC;SAC3D,MAAM,CAAC,eAAe,EAAE,0CAA0C,CAAC;SACnE,MAAM,CAAC,aAAa,EAAE,mEAAmE,CAAC;SAC1F,MAAM,CAAC,0BAA0B,EAAE,yCAAyC,CAAC;SAC7E,WAAW,CACV,OAAO,EACP;;;;;;;;+DAQyD,CAC1D;SACA,MAAM,CACL,iBAAiB,CAAC,KAAK,EAAE,KAA8B,EAAE,GAAY,EAAE,EAAE;QACvE,MAAM,UAAU,GAAG,GAAG,CAAC,eAAe,EAAmB,CAAC;QAC1D,MAAM,IAAI,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;QAE3C,MAAM,KAAK,GAAyB;YAClC,MAAM,EAAE,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC;YAC1C,IAAI,EAAE,YAAY,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC;YAC9D,EAAE,EAAE,YAAY,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC;SACzD,CAAC;QACF,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAC9B,KAAK,CAAC,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,SAAmB,CAAC,CAAC;QAE7D,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,eAAe,CAC1B,MAAM,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EACzC,wBAAwB,CACzB,CAAC;QACF,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/B,CAAC,CAAC,CACH,CAAC;AACN,CAAC;AAED,SAAS,mBAAmB;IAC1B,MAAM,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,GAAG,kBAAkB,CAAC;IAEnF,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC;SAC1B,WAAW,CAAC,2DAA2D,CAAC;SACxE,MAAM,CACL,mBAAmB,EACnB,4BAA4B,2BAA2B,CAAC,OAAO,IAAI,2BAA2B,CAAC,OAAO,GAAG,CAC1G;SACA,MAAM,CAAC,YAAY,EAAE,qBAAqB,CAAC;SAC3C,MAAM,CACL,aAAa,EACb,qBAAqB,sBAAsB,CAAC,OAAO,IAAI,sBAAsB,CAAC,OAAO,GAAG,CACzF;SACA,MAAM,CAAC,oBAAoB,EAAE,qCAAqC,CAAC;SACnE,WAAW,CACV,OAAO,EACP;;;;;;;;8DAQwD,CACzD;SACA,MAAM,CACL,iBAAiB,CAAC,KAAK,EAAE,KAA8B,EAAE,GAAY,EAAE,EAAE;QACvE,MAAM,UAAU,GAAG,GAAG,CAAC,eAAe,EAAmB,CAAC;QAC1D,MAAM,IAAI,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;QAE3C,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;YAC/B,KAAK,CAAC,UAAU,GAAG,gBAAgB,CACjC,IAAI,CAAC,UAAoB,EACzB,eAAe,EACf,2BAA2B,CAAC,OAAO,CACpC,CAAC;QACJ,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAc,EAAE,QAAQ,CAAC,CAAC;QAC1F,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAC1B,KAAK,CAAC,KAAK,GAAG,gBAAgB,CAC5B,IAAI,CAAC,KAAe,EACpB,SAAS,EACT,sBAAsB,CAAC,OAAO,CAC/B,CAAC;QACJ,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAC1B,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,KAAe,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAEnE,MAAM,MAAM,GAAG,MAAM,6BAA6B,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,qBAAqB,CAAC,CAAC;QAC5F,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/B,CAAC,CAAC,CACH,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC;SAC1C,WAAW,CAAC,yEAAyE,CAAC;SACtF,MAAM,CAAC,mBAAmB,EAAE,kBAAkB,CAAC;SAC/C,MAAM,CAAC,oBAAoB,EAAE,0BAA0B,CAAC;SACxD,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;SAC5C,MAAM,CAAC,eAAe,EAAE,uDAAuD,CAAC;SAChF,MAAM,CAAC,aAAa,EAAE,wDAAwD,CAAC;SAC/E,MAAM,CAAC,0BAA0B,EAAE,mCAAmC,CAAC;SACvE,MAAM,CAAC,YAAY,EAAE,qBAAqB,CAAC;SAC3C,MAAM,CACL,aAAa,EACb,qBAAqB,kBAAkB,CAAC,eAAe,CAAC,OAAO,IAAI,kBAAkB,CAAC,eAAe,CAAC,OAAO,GAAG,CACjH;SACA,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;iGAY2F,CAC5F;SACA,MAAM,CACL,iBAAiB,CAAC,KAAK,EAAE,IAA6B,EAAE,GAAY,EAAE,EAAE;QACtE,MAAM,UAAU,GAAG,GAAG,CAAC,eAAe,EAAmB,CAAC;QAE1D,MAAM,KAAK,GAAoB,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAgB,CAAC;QACpE,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;YAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,OAAiB,CAAC;QACvE,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;QACjE,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAc,CAAC;QAC9D,IAAI,IAAI,CAAC,EAAE,KAAK,SAAS;YAAE,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,EAAY,CAAC;QACxD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAC9B,KAAK,CAAC,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,SAAmB,CAAC,CAAC;QAC7D,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAc,EAAE,QAAQ,CAAC,CAAC;QAC1F,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAC1B,KAAK,CAAC,KAAK,GAAG,gBAAgB,CAC5B,IAAI,CAAC,KAAe,EACpB,SAAS,EACT,kBAAkB,CAAC,eAAe,CAAC,OAAO,CAC3C,CAAC;QAEJ,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QACpD,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/B,CAAC,CAAC,CACH,CAAC;IAEJ,UAAU,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,CAAC;IACjD,UAAU,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAChD,UAAU,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAE7C,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/commands/reference-profile.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+/** `purvey reference-profile` — owner-scoped Studio plans through Parchment's SDK. */
+export declare function buildReferenceProfileCommand(): Command;
+//# sourceMappingURL=reference-profile.d.ts.map

package/dist/commands/reference-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-profile.d.ts","sourceRoot":"","sources":["../../src/commands/reference-profile.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgCpC,sFAAsF;AACtF,wBAAgB,4BAA4B,IAAI,OAAO,CAsTtD"}

package/dist/commands/reference-profile.js

@@ -0,0 +1,200 @@
+import { basename } from 'node:path';
+import { readFile, stat } from 'node:fs/promises';
+import { Command } from 'commander';
+import { PrvrsError, withErrorHandling } from '../lib/errors.js';
+import { compareProfiles, exportGeneratedReferenceProfile, getReferenceProfile, getReferenceProfileChart, importReferenceProfile, listReferenceProfiles, parseProfileComparisonSelector, parseReferenceProfileImportRequest, previewReferenceProfile, PROFILE_COMPARISON_TARGET_POINTS, profileComparisonUnits, readReferenceProfileGenerationRequest, REFERENCE_PROFILE_SOURCE_MAX_BYTES, saveGeneratedReferenceProfile, writeGeneratedReferenceFile, } from '../lib/reference-profiles.js';
+import { normalizePathInput } from '../lib/path-input.js';
+import { outputData } from '../lib/output.js';
+import { parseStrictPositiveCount } from '../lib/strict-number.js';
+function idempotencyKeyOption(command, description) {
+    return command.option('--idempotency-key <key>', `${description}; a new UUID is generated when omitted`);
+}
+/** `purvey reference-profile` — owner-scoped Studio plans through Parchment's SDK. */
+export function buildReferenceProfileCommand() {
+    const referenceProfile = new Command('reference-profile').description('Compare, preview, save, and export Studio Artisan reference plans through Parchment');
+    referenceProfile
+        .command('list')
+        .description('List your Studio reference profiles')
+        .option('--include-archived', 'Include archived reference profiles')
+        .addHelpText('after', `
+Examples:
+  purvey reference-profile list --pretty
+  purvey reference-profile list --include-archived --json
+
+Notes:
+  Requires a member credential and Studio access; entitlement is enforced by Parchment.`)
+        .action(withErrorHandling(async (opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        const data = await listReferenceProfiles(Boolean(opts.includeArchived));
+        outputData(data, globalOpts);
+    }));
+    referenceProfile
+        .command('get <profile-id>')
+        .description('Get one reference profile and its current revision')
+        .addHelpText('after', `
+Example:
+  purvey reference-profile get 5ea1af6f-234c-43a9-9bf8-5678dd24f854 --pretty
+
+Use data.currentRevision.id as the revision id for chart, preview, and save.`)
+        .action(withErrorHandling(async (profileId, _opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        const data = await getReferenceProfile(profileId);
+        outputData(data, globalOpts);
+    }));
+    referenceProfile
+        .command('chart <profile-id> <revision-id>')
+        .description('Get the typed Artisan chart for a reference revision')
+        .addHelpText('after', `
+Example:
+  purvey reference-profile chart 5ea1af6f-234c-43a9-9bf8-5678dd24f854 8d2c41e0-7b9a-4f3e-a6d1-2c9e5f07b3a4 --pretty`)
+        .action(withErrorHandling(async (profileId, revisionId, _opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        const data = await getReferenceProfileChart(profileId, revisionId);
+        outputData(data, globalOpts);
+    }));
+    referenceProfile
+        .command('compare <left> <right>')
+        .description('Compare two immutable roast or reference revisions with measured deltas')
+        .option('--unit <F|C>', 'Temperature unit for the comparison series', 'F')
+        .option('--target-points <n>', `Samples per aligned series (${PROFILE_COMPARISON_TARGET_POINTS.minimum}-${PROFILE_COMPARISON_TARGET_POINTS.maximum})`, String(PROFILE_COMPARISON_TARGET_POINTS.default))
+        .addHelpText('after', `
+Examples:
+  purvey reference-profile compare roast:123 profile:5ea1af6f-234c-43a9-9bf8-5678dd24f854 --pretty
+  purvey reference-profile compare roast:123 roast:124 --unit C --json
+  purvey reference-profile compare revision:8d2c41e0-7b9a-4f3e-a6d1-2c9e5f07b3a4 roast:123@2026-09-30T14:22:05.123456+00:00 --pretty
+
+Selectors:
+  revision:<uuid>          exact reference-profile revision
+  profile:<uuid>           the reference profile's current revision
+  roast:<roast-id>         the executed roast's current chart revision
+  roast:<roast-id>@<rev>   an exact executed-roast chart revision (data.metadata.revision from 'purvey roast chart')
+
+Notes:
+  Parchment aligns both sides at charge and returns measured deltas and milestones unchanged.
+  A reference profile is a plan or comparison reference, never executed roast history.
+  Requires a member credential and Studio access; entitlement is enforced by Parchment.`)
+        .action(withErrorHandling(async (left, right, opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        const unit = String(opts.unit).trim().toUpperCase();
+        if (!profileComparisonUnits.includes(unit)) {
+            throw new PrvrsError('INVALID_ARGUMENT', `Invalid --unit: "${String(opts.unit)}". Must be one of: ${profileComparisonUnits.join(', ')}.`);
+        }
+        const targetPoints = parseStrictPositiveCount(String(opts.targetPoints));
+        if (!Number.isFinite(targetPoints) ||
+            targetPoints < PROFILE_COMPARISON_TARGET_POINTS.minimum ||
+            targetPoints > PROFILE_COMPARISON_TARGET_POINTS.maximum) {
+            throw new PrvrsError('INVALID_ARGUMENT', `Invalid --target-points: "${String(opts.targetPoints)}". Must be an integer between ${PROFILE_COMPARISON_TARGET_POINTS.minimum} and ${PROFILE_COMPARISON_TARGET_POINTS.maximum}.`);
+        }
+        const data = await compareProfiles({
+            left: parseProfileComparisonSelector(left, 'left'),
+            right: parseProfileComparisonSelector(right, 'right'),
+            targetUnit: unit,
+            targetPoints,
+        });
+        outputData(data, globalOpts);
+    }));
+    const importCommand = referenceProfile
+        .command('import <file>')
+        .description('Upload an Artisan reference file as a private Studio profile')
+        .option('--title <text>', 'Title for the reference profile')
+        .option('--notes <text>', 'Notes about the reference profile')
+        .addHelpText('after', `
+Examples:
+  purvey reference-profile import ~/artisan/ethiopia.alog --title "Ethiopia baseline" --pretty
+  purvey reference-profile import ~/artisan/ethiopia.alog --idempotency-key 3f6c2a1b-8e4d-4b7a-9c05-7e1f2d3a4b5c --json
+
+Notes:
+  Parchment parses and retains the private source (up to 10,000,000 bytes); this command does not create roast history.
+  Reuse an explicit idempotency key to safely retry the same upload.`);
+    idempotencyKeyOption(importCommand, 'Stable key for safe retries');
+    importCommand.action(withErrorHandling(async (inputPath, opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        const filePath = normalizePathInput(inputPath);
+        if (!filePath) {
+            throw new PrvrsError('INVALID_ARGUMENT', 'The Artisan reference file path cannot be blank.');
+        }
+        const fileInfo = await stat(filePath);
+        if (!fileInfo.isFile()) {
+            throw new PrvrsError('INVALID_ARGUMENT', 'The Artisan reference path must be a file.');
+        }
+        if (fileInfo.size === 0 || fileInfo.size > REFERENCE_PROFILE_SOURCE_MAX_BYTES) {
+            throw new PrvrsError('INVALID_ARGUMENT', `The Artisan reference must be between 1 and ${REFERENCE_PROFILE_SOURCE_MAX_BYTES} bytes.`);
+        }
+        const fileContent = await readFile(filePath, 'utf8');
+        const body = parseReferenceProfileImportRequest({
+            ...(opts.title !== undefined ? { title: String(opts.title) } : {}),
+            ...(opts.notes !== undefined ? { notes: String(opts.notes) } : {}),
+            fileName: basename(filePath),
+            fileContent,
+            fileSize: Buffer.byteLength(fileContent, 'utf8'),
+        });
+        const data = await importReferenceProfile(body, opts.idempotencyKey ? String(opts.idempotencyKey) : undefined);
+        outputData(data, globalOpts);
+    }));
+    const previewCommand = referenceProfile
+        .command('preview <profile-id> <revision-id>')
+        .description('Preview a bounded set of temperature adjustments without saving')
+        .requiredOption('--request <file>', 'JSON file with a title and bounded temperature adjustments')
+        .addHelpText('after', `
+Example:
+  purvey reference-profile preview 5ea1af6f-234c-43a9-9bf8-5678dd24f854 8d2c41e0-7b9a-4f3e-a6d1-2c9e5f07b3a4 --request changes.json --pretty
+
+The request file is also the exact body accepted by save: title, optional notes, optional
+userGoal/modelRecommendation/userEdits provenance, and changes.temperatureAdjustments.
+Parchment recalculates from the immutable parent; preview never changes or stores the source.`);
+    previewCommand.action(withErrorHandling(async (profileId, revisionId, opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        const request = await readReferenceProfileGenerationRequest(String(opts.request));
+        const data = await previewReferenceProfile(profileId, revisionId, request);
+        outputData(data, globalOpts);
+    }));
+    const saveCommand = referenceProfile
+        .command('save <profile-id> <revision-id>')
+        .description('Save the previewed changes as a new immutable generated reference')
+        .requiredOption('--request <file>', 'JSON file with a title and bounded temperature adjustments');
+    idempotencyKeyOption(saveCommand, 'Stable key for safe retries');
+    saveCommand.addHelpText('after', `
+Example:
+  purvey reference-profile save 5ea1af6f-234c-43a9-9bf8-5678dd24f854 8d2c41e0-7b9a-4f3e-a6d1-2c9e5f07b3a4 --request changes.json --pretty
+
+Notes:
+  Omit --idempotency-key to generate a new key for this call. Reuse an explicit key to replay a retry.
+  A generated reference is a plan, not executed roast history.`);
+    saveCommand.action(withErrorHandling(async (profileId, revisionId, opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        const request = await readReferenceProfileGenerationRequest(String(opts.request));
+        const data = await saveGeneratedReferenceProfile(profileId, revisionId, request, opts.idempotencyKey ? String(opts.idempotencyKey) : undefined);
+        outputData(data, globalOpts);
+    }));
+    const exportCommand = referenceProfile
+        .command('export <profile-id> <revision-id>')
+        .description('Download a saved generated reference as an unsigned Artisan .alog plan')
+        .requiredOption('--output <file>', 'Destination for the generated .alog file')
+        .option('--force', 'Overwrite the destination file if it already exists')
+        .addHelpText('after', `
+Example:
+  purvey reference-profile export 0b7e9f52-3c61-4d8a-9e24-6f1a8c3d5b90 c43a1d7e-95b2-4e06-8f7c-1d2b3a4e5f68 --output ~/artisan/next-batch.alog
+
+Only a saved generated revision can be exported. Export writes the .alog file locally and
+prints a JSON receipt; it does not claim verified Artisan 4.2 playback compatibility.`);
+    exportCommand.action(withErrorHandling(async (profileId, revisionId, opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        const destination = normalizePathInput(String(opts.output ?? ''));
+        if (!destination) {
+            throw new PrvrsError('INVALID_ARGUMENT', 'The export destination path cannot be blank.');
+        }
+        const result = await exportGeneratedReferenceProfile(profileId, revisionId);
+        const outputFile = await writeGeneratedReferenceFile(result.data.fileContent, destination, Boolean(opts.force));
+        outputData({
+            data: {
+                profileId,
+                revisionId,
+                fileName: result.data.fileName,
+                fileSize: result.data.fileSize,
+                outputPath: outputFile,
+            },
+        }, globalOpts);
+    }));
+    return referenceProfile;
+}
+//# sourceMappingURL=reference-profile.js.map

package/dist/commands/reference-profile.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"roast.d.ts","sourceRoot":"","sources":["../../src/commands/roast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,OAAO,EAAwB,WAAW,EAA4B,MAAM,iBAAiB,CAAC;AAC9F,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAO/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAUjD,4DAA4D;AAC5D,KAAK,kBAAkB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,qBAAqB,CAAC,CAAC;AAGvE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAsDhE;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,kBAAkB,EAC3B,gBAAgB,EAAE,MAAM,EACxB,iBAAiB,EAAE,MAAM,GACxB,iBAAiB,CAyDnB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,iBAAiB,EAAE,iBAAiB,GAAG,kBAAkB,CAwBjG;AAED,6FAA6F;AAC7F,wBAAsB,sBAAsB,CAC1C,iBAAiB,EAAE,iBAAiB,EACpC,KAAK,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,GACvC,OAAO,CAAC,YAAY,CAAC,CAQvB;AAcD;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAm5B3C"}
+{"version":3,"file":"roast.d.ts","sourceRoot":"","sources":["../../src/commands/roast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,OAAO,EAIL,WAAW,EAIZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAO/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAUjD,4DAA4D;AAC5D,KAAK,kBAAkB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,qBAAqB,CAAC,CAAC;AAGvE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAkEhE;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,kBAAkB,EAC3B,gBAAgB,EAAE,MAAM,EACxB,iBAAiB,EAAE,MAAM,GACxB,iBAAiB,CAyDnB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,iBAAiB,EAAE,iBAAiB,GAAG,kBAAkB,CAwBjG;AAED,6FAA6F;AAC7F,wBAAsB,sBAAsB,CAC1C,iBAAiB,EAAE,iBAAiB,EACpC,KAAK,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,GACvC,OAAO,CAAC,YAAY,CAAC,CAQvB;AAcD;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CA+7B3C"}

package/dist/commands/roast.js

@@ -6,7 +6,7 @@ import { outputData, info, success } from '../lib/output.js';
 import { withErrorHandling, PrvrsError, AuthError } from '../lib/errors.js';
 import { requireAuth } from '../lib/auth-guard.js';
 import { confirm, todayIso } from '../lib/prompts.js';
-import { listRoasts, getRoast, createRoast, deleteRoast, updateRoast } from '../lib/roast.js';
+import { listRoasts, getRoast, getRoastChartData, createRoast, deleteRoast, updateRoast, ROAST_CHART_TARGET_POINTS, } from '../lib/roast.js';
 import { pickBean, guardCancel } from '../lib/interactive/forms.js';
 import { normalizePathInput } from '../lib/path-input.js';
 import { startWatch, loadWatchSession } from '../lib/interactive/watch.js';
@@ -29,6 +29,14 @@ function parseRoastListCount(value, flag) {
     }
     return parsed;
 }
+function parseRoastChartTargetPoints(value) {
+    const parsed = parseStrictPositiveCount(value);
+    const { minimum, maximum } = ROAST_CHART_TARGET_POINTS;
+    if (!Number.isFinite(parsed) || parsed < minimum || parsed > maximum) {
+        throw new PrvrsError('INVALID_ARGUMENT', `Invalid --target-points: "${value}". Must be an integer between ${minimum} and ${maximum}.`);
+    }
+    return parsed;
+}
 function parseWatchCommitMode(value, fallback = 'batch') {
     if (value === undefined || value === null || String(value).trim() === '') {
         return fallback;
@@ -273,6 +281,34 @@ Notes:
         });
         outputData(data, globalOpts);
     }));
+    // ── roast chart <id> ──────────────────────────────────────────────────────
+    roast
+        .command('chart <id>')
+        .description('Fetch the sampled chart model for one roast (series, events, revision)')
+        .option('--target-points <n>', `Approximate samples per series (${ROAST_CHART_TARGET_POINTS.minimum}-${ROAST_CHART_TARGET_POINTS.maximum}; Parchment defaults to 400)`)
+        .addHelpText('after', `
+Examples:
+  purvey roast chart 123 --pretty
+  purvey roast chart 123 --target-points 120 --json
+  purvey roast chart 123 | jq '.data.metadata.revision'
+
+Notes:
+  <id> is roast_data.roast_id (integer).
+  Returns Parchment's canonical chart-data envelope unchanged: sampled series,
+  discrete events, and metadata. data.metadata.revision identifies the immutable
+  chart revision accepted by 'purvey reference-profile compare roast:<id>@<revision>'.
+  Requires authentication (member role); API keys need the roast:read scope.
+`)
+        .action(withErrorHandling(async (id, opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        const data = await getRoastChartData({
+            id: parseRoastInt4Id(id, 'roast ID'),
+            targetPoints: opts.targetPoints === undefined
+                ? undefined
+                : parseRoastChartTargetPoints(String(opts.targetPoints)),
+        });
+        outputData(data, globalOpts);
+    }));
     // ── roast create ──────────────────────────────────────────────────────────
     roast
         .command('create')
@@ -283,6 +319,8 @@ Notes:
         .option('--oz-out <oz>', 'Roasted weight in ounces')
         .option('--roast-date <YYYY-MM-DD>', 'Roast date (defaults to today)')
         .option('--notes <text>', 'Roast notes')
+        .option('--targets <text>', 'Roast targets (planning goals for this roast)')
+        .option('--roaster-type <text>', 'Roaster model or type')
         .option('--form', 'Interactive form mode (browse and select bean)')
         .addHelpText('after', `
 Examples:
@@ -290,6 +328,7 @@ Examples:
   purvey roast create --coffee-id 7 --batch-name "Ethiopia Guji Light" --oz-in 16
   purvey roast create --coffee-id 42 --oz-in 12 --oz-out 9.8 --roast-date 2026-03-15
   purvey roast create --coffee-id 7 --notes "Extended drying phase, aimed for medium roast"
+  purvey roast create --coffee-id 7 --targets "FC at 390F, 18% development" --roaster-type "Aillio Bullet"
   purvey roast create --form     # interactive wizard
 
 Required flags: --coffee-id (green_coffee_inv.id)
@@ -387,6 +426,8 @@ Required flags: --coffee-id (green_coffee_inv.id)
             ozOut,
             roastDate: opts.roastDate ?? todayIso(),
             notes: opts.notes,
+            targets: opts.targets,
+            roasterType: opts.roasterType,
         });
         success(`Roast profile ${data.roast_id} created.`);
         outputData(data, globalOpts);