@purveyors/cli 0.9.6 → 0.15.1

package/dist/commands/context.js

@@ -1,244 +1,44 @@
 import { Command } from 'commander';
-// This text is intentionally dense. An agent should be able to read it once,
-// then use the CLI correctly without hunting through help output.
-const CONTEXT_TEXT = `
-PURVEY CLI - Agent Reference
-============================
-Official CLI for purveyors.io. Node.js 20+.
-Credentials file: ~/.config/purvey/credentials.json
-Config file: ~/.config/purvey/config.json
-
-ROLES
------
-viewer  valid authenticated session; required for catalog commands
-member  required for inventory, roast, sales, and tasting commands
-
-AUTH
-----
-Interactive login:
-  purvey auth login
-
-Headless login:
-  purvey auth login --headless
-  1. CLI prints a Google OAuth URL
-  2. User opens it in any browser and signs in
-  3. User pastes the full callback URL back into the terminal
-
-Status:
-  purvey auth status
-  purvey auth status --pretty
-
-Logout:
-  purvey auth logout
-
-OUTPUT
-------
-Most commands emit compact JSON to stdout by default.
-Use --json to request compact JSON explicitly.
-Use --pretty for indented JSON.
-Use --csv for array-shaped results that support CSV output.
-User feedback goes to stderr.
-
-Important exception:
-- auth status prints human-readable output in an interactive TTY unless --json, --pretty, or --csv is passed; otherwise it emits structured output
-
-ID MAP
-------
-catalog_id      coffee_catalog row; used by catalog get, inventory add --catalog-id, tasting get, roast list --catalog-id
-inventory_id    green_coffee_inv row; used by inventory get/update/delete, roast --coffee-id, roast list --coffee-id, tasting rate
-roast_id        roast_data row; used by roast get/delete, roast list --roast-id, sales --roast-id
-sale_id         coffee_sales row; used by sales update/delete
-
-COMMANDS
---------
-auth
-  login [--headless]
-  status
-  logout
-
-catalog
-  search [options]
-    --origin <text>
-    --process <method>
-    --price-min <n>
-    --price-max <n>
-    --flavor <keywords>
-    --name <text>
-    --supplier <name>
-    --ids <n,n,...>
-    --variety <text>
-    --drying-method <text>
-    --stocked-days <n>
-    --stocked
-    --sort <price|price-desc|name|origin|newest>
-    --offset <n>
-    --limit <n>
-  get <catalog_id>
-  stats
-  similar <catalog_id>
-    --threshold <0-1>     default 0.70
-    --limit <n>           default 10
-    --stocked-only
-
-inventory (member)
-  list
-    --stocked
-    --catalog-id <catalog_id>
-    --purchase-date-start <YYYY-MM-DD>
-    --purchase-date-end <YYYY-MM-DD>
-    --origin <country>
-    --limit <n>
-    --offset <n>
-  get <inventory_id>
-  add
-    --catalog-id <id>     required in flag mode
-    --qty <lbs>           required in flag mode
-    --cost <dollars>
-    --tax-ship <dollars>
-    --notes <text>
-    --purchase-date <YYYY-MM-DD>
-    --form
-  update <inventory_id>
-    --qty <lbs>
-    --cost <dollars>
-    --tax-ship <dollars>
-    --notes <text>
-    --stocked <true|false>
-  delete <inventory_id> [--yes] [--force]
-    --force     cascade delete dependent roast profiles and sales records before deleting the item
-                without --force, delete fails with DEPENDENCY_CONFLICT if dependents exist
-
-roast (member)
-  list
-    --coffee-id <inventory_id>
-    --roast-id <roast_id>
-    --batch-name <text>
-    --coffee-name <text>
-    --date-start <YYYY-MM-DD>
-    --date-end <YYYY-MM-DD>
-    --stocked
-    --catalog-id <catalog_id>
-    --limit <n>
-    --offset <n>
-  get <roast_id>
-    --include-temps
-    --include-events
-  create
-    --coffee-id <inventory_id>   required in flag mode
-    --batch-name <name>
-    --oz-in <oz>
-    --oz-out <oz>
-    --roast-date <YYYY-MM-DD>
-    --notes <text>
-    --form
-  update <roast_id>
-    --notes <text>
-    --oz-out <oz>
-    --batch-name <name>
-    --targets <text>
-  delete <roast_id> [--yes]
-  import [file]
-    --coffee-id <inventory_id>   required in flag mode
-    --batch-name <name>
-    --oz-in <oz>
-    --roast-notes <text>
-    --form
-  watch [directory]
-    --coffee-id <inventory_id>   required unless --auto-match
-    --batch-prefix <name>
-    --prompt-each
-    --auto-match                 mutually exclusive with --coffee-id
-    --resume
-    --form
-
-sales (member)
-  list
-    --roast-id <roast_id>
-    --date-start <YYYY-MM-DD>
-    --date-end <YYYY-MM-DD>
-    --buyer <name>
-    --limit <n>
-    --offset <n>
-  record
-    --roast-id <roast_id>   required in flag mode
-    --oz <amount>           required in flag mode
-    --price <dollars>       required in flag mode
-    --buyer <name>
-    --sell-date <YYYY-MM-DD>
-    --form
-  update <sale_id>
-    --oz <amount>
-    --price <dollars>
-    --buyer <name>
-    --sell-date <YYYY-MM-DD>
-  delete <sale_id> [--yes]
-
-tasting (member)
-  get <catalog_id>
-    --filter <user|supplier|both>   default both
-  rate [inventory_id]
-    --aroma <1-5>        required in flag mode
-    --body <1-5>         required in flag mode
-    --acidity <1-5>      required in flag mode
-    --sweetness <1-5>    required in flag mode
-    --aftertaste <1-5>   required in flag mode
-    --brew-method <method>
-    --notes <text>
-    --form
-
-config
-  list
-  get <key>
-  set <key> <value>
-  reset
-
-Current config keys:
-  form-mode  true|false
-
-WORKFLOWS
----------
-Catalog -> inventory:
-  purvey catalog search --origin "Ethiopia" --stocked --pretty
-  purvey inventory add --catalog-id 128 --qty 10 --cost 8.50
-
-Import a roast from Artisan:
-  purvey inventory list --stocked --pretty
-  purvey roast import ~/artisan/ethiopia.alog --coffee-id 7 --pretty
-
-Watch a folder for new roasts:
-  purvey roast watch ~/artisan/ --coffee-id 7
-  purvey roast watch ~/artisan/ --auto-match
-  purvey roast watch --resume
-
-Rate coffee and record a sale:
-  purvey tasting rate 7 --aroma 4 --body 3 --acidity 5 --sweetness 4 --aftertaste 4
-  purvey sales record --roast-id 123 --oz 12 --price 22.00 --buyer "Jane Smith"
-
-ERROR PATTERNS
---------------
-Not logged in:
-  run purvey auth login or purvey auth login --headless
-
-Wrong ID type:
-  verify whether the command wants catalog_id, inventory_id, roast_id, or sale_id
-
-Missing required args in write commands:
-  pass the required flags or use --form
-
-Mutually exclusive watch flags:
-  roast watch forbids using --auto-match together with --coffee-id
-`.trim();
+import { PrvrsError, withErrorHandling } from '../lib/errors.js';
+import { getCliManifest, renderContextText } from '../lib/manifest.js';
+import { outputData } from '../lib/output.js';
 export function buildContextCommand() {
     return new Command('context')
-        .description('Output full CLI reference for AI agent onboarding')
+        .description('Output the dense human-readable operator reference; use --json/--pretty only for manifest parity')
+        .option('--json', 'Emit the machine-readable manifest contract as compact JSON')
+        .option('--pretty', 'Emit the machine-readable manifest contract as indented JSON')
         .addHelpText('after', `
+Default output is the dense human-readable operator reference.
+Preferred machine contract: \`purvey manifest\`.
+Use --json or --pretty only when an existing \`purvey context\` caller needs manifest parity.
+Use \`@purveyors/cli/manifest\` for the same contract inside Node.js or agent runtimes.
+
 Examples:
   purvey context
   purvey context | head -50
-  purvey context > cli-reference.txt
+  purvey context --json
+  purvey context --pretty
+  purvey context --json > cli-manifest.json
+  purvey manifest
 `)
-        .action(() => {
-        console.log(CONTEXT_TEXT);
-    });
+        .action(withErrorHandling(async (opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        const manifest = getCliManifest();
+        const wantsJson = Boolean(opts.json) ||
+            Boolean(opts.pretty) ||
+            Boolean(globalOpts.json) ||
+            Boolean(globalOpts.pretty);
+        if (globalOpts.csv) {
+            throw new PrvrsError('INVALID_ARGUMENT', 'The context command does not support --csv. Use text, --json, or --pretty.');
+        }
+        if (wantsJson) {
+            outputData(manifest, {
+                json: true,
+                pretty: Boolean(opts.pretty) || Boolean(globalOpts.pretty),
+            });
+            return;
+        }
+        console.log(renderContextText(manifest));
+    }));
 }
 //# sourceMappingURL=context.js.map

package/dist/commands/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,6EAA6E;AAC7E,kEAAkE;AAElE,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkOpB,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC;SAC1B,WAAW,CAAC,mDAAmD,CAAC;SAChE,WAAW,CACV,OAAO,EACP;;;;;CAKL,CACI;SACA,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC;SAC1B,WAAW,CACV,kGAAkG,CACnG;SACA,MAAM,CAAC,QAAQ,EAAE,6DAA6D,CAAC;SAC/E,MAAM,CAAC,UAAU,EAAE,8DAA8D,CAAC;SAClF,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;CAaL,CACI;SACA,MAAM,CACL,iBAAiB,CAAC,KAAK,EAAE,IAA6B,EAAE,GAAY,EAAE,EAAE;QACtE,MAAM,UAAU,GAAG,GAAG,CAAC,eAAe,EAAmB,CAAC;QAC1D,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;QAClC,MAAM,SAAS,GACb,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;YACpB,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;YACxB,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAE7B,IAAI,UAAU,CAAC,GAAG,EAAE,CAAC;YACnB,MAAM,IAAI,UAAU,CAClB,kBAAkB,EAClB,4EAA4E,CAC7E,CAAC;QACJ,CAAC;QAED,IAAI,SAAS,EAAE,CAAC;YACd,UAAU,CAAC,QAAQ,EAAE;gBACnB,IAAI,EAAE,IAAI;gBACV,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC;aAC3D,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CACH,CAAC;AACN,CAAC"}

package/dist/commands/manifest.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function buildManifestCommand(): Command;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/commands/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,oBAAoB,IAAI,OAAO,CAsC9C"}

package/dist/commands/manifest.js

@@ -0,0 +1,32 @@
+import { Command } from 'commander';
+import { PrvrsError, withErrorHandling } from '../lib/errors.js';
+import { getCliManifest } from '../lib/manifest.js';
+import { outputData } from '../lib/output.js';
+export function buildManifestCommand() {
+    return new Command('manifest')
+        .description('Output the preferred stable machine-readable CLI manifest contract for shells and agents')
+        .option('--json', 'Emit the manifest as compact JSON (default)')
+        .option('--pretty', 'Emit the manifest as indented JSON')
+        .addHelpText('after', `
+Preferred machine-readable entrypoint for shells, scripts, and agents.
+Use \`purvey context --json\` only for compatibility with existing context-based callers.
+
+Examples:
+  purvey manifest
+  purvey manifest --pretty
+  purvey manifest > cli-manifest.json
+  purvey manifest | jq '.commandGroups[].name'
+  node --input-type=module -e "import { getCliManifest } from '@purveyors/cli/manifest'; console.log(JSON.stringify(getCliManifest()))"
+`)
+        .action(withErrorHandling(async (opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        if (globalOpts.csv) {
+            throw new PrvrsError('INVALID_ARGUMENT', 'The manifest command does not support --csv. Use --json or --pretty.');
+        }
+        outputData(getCliManifest(), {
+            json: true,
+            pretty: Boolean(opts.pretty) || Boolean(globalOpts.pretty),
+        });
+    }));
+}
+//# sourceMappingURL=manifest.js.map

package/dist/commands/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/commands/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;SAC3B,WAAW,CACV,0FAA0F,CAC3F;SACA,MAAM,CAAC,QAAQ,EAAE,6CAA6C,CAAC;SAC/D,MAAM,CAAC,UAAU,EAAE,oCAAoC,CAAC;SACxD,WAAW,CACV,OAAO,EACP;;;;;;;;;;CAUL,CACI;SACA,MAAM,CACL,iBAAiB,CAAC,KAAK,EAAE,IAA6B,EAAE,GAAY,EAAE,EAAE;QACtE,MAAM,UAAU,GAAG,GAAG,CAAC,eAAe,EAAmB,CAAC;QAE1D,IAAI,UAAU,CAAC,GAAG,EAAE,CAAC;YACnB,MAAM,IAAI,UAAU,CAClB,kBAAkB,EAClB,sEAAsE,CACvE,CAAC;QACJ,CAAC;QAED,UAAU,CAAC,cAAc,EAAE,EAAE;YAC3B,IAAI,EAAE,IAAI;YACV,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC;SAC3D,CAAC,CAAC;IACL,CAAC,CAAC,CACH,CAAC;AACN,CAAC"}

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;AAgBpC,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,EAEhB,MAAM,iBAAiB,CAAC;AAOzB,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAIhE;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAyyB3C"}
+{"version":3,"file":"roast.d.ts","sourceRoot":"","sources":["../../src/commands/roast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBpC,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,EAEhB,MAAM,iBAAiB,CAAC;AAOzB,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAIhE;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAk6B3C"}

package/dist/commands/roast.js

@@ -342,12 +342,14 @@ Notes:
         .option('--batch-name <name>', 'Batch name (auto-generated from coffee name + date if omitted)')
         .option('--oz-in <oz>', 'Green weight in ounces (extracted from .alog if omitted)')
         .option('--roast-notes <notes>', 'Additional roast notes')
+        .option('--roast-targets <targets>', 'Roast targets to store with the import')
         .option('--form', 'Interactive form mode (browse and select bean)')
         .addHelpText('after', `
 Examples:
   purvey roast import ~/artisan/ethiopia-guji.alog --coffee-id 7 --pretty
   purvey roast import roast.alog --coffee-id 42 --oz-in 16
   purvey roast import roast.alog --coffee-id 7 --batch-name "Ethiopia Guji #3" --roast-notes "Faster development"
+  purvey roast import roast.alog --coffee-id 7 --roast-targets "Aim for 18% development"
   purvey roast import --form     # interactive wizard (browse files + select bean)
 
 Required: <file> path and --coffee-id (unless using --form)
@@ -410,6 +412,11 @@ Required: <file> path and --coffee-id (unless using --form)
                 placeholder: 'optional',
             });
             guardCancel(roastNotesRaw);
+            const roastTargetsRaw = await p.text({
+                message: 'Roast targets',
+                placeholder: 'optional',
+            });
+            guardCancel(roastTargetsRaw);
             const confirmed = await p.confirm({ message: 'Import this roast?' });
             guardCancel(confirmed);
             if (!confirmed) {
@@ -422,6 +429,7 @@ Required: <file> path and --coffee-id (unless using --form)
             const ozIn = ozInStr !== '' ? parseFloat(ozInStr) : undefined;
             const batchName = String(batchNameRaw).trim() || defaultBatch;
             const notesStr = String(roastNotesRaw).trim();
+            const targetsStr = String(roastTargetsRaw).trim();
             const spin = p.spinner();
             spin.start('Importing roast data...');
             const result = await importRoastFromFile(supabase, userId, {
@@ -431,6 +439,7 @@ Required: <file> path and --coffee-id (unless using --form)
                 batchName,
                 ozIn,
                 roastNotes: notesStr !== '' ? notesStr : undefined,
+                roastTargets: targetsStr !== '' ? targetsStr : undefined,
             });
             spin.stop('Done');
             p.outro(`Roast imported! Profile #${result.roast_id} created.`);
@@ -469,6 +478,9 @@ Required: <file> path and --coffee-id (unless using --form)
                 throw new PrvrsError('INVALID_ARGUMENT', `Invalid --oz-in: "${opts.ozIn}".`);
             }
         }
+        const roastTargets = typeof opts.roastTargets === 'string' && opts.roastTargets.trim() !== ''
+            ? opts.roastTargets.trim()
+            : undefined;
         // 6. Run the import
         const result = await importRoastFromFile(supabase, userId, {
             fileContent,
@@ -477,6 +489,7 @@ Required: <file> path and --coffee-id (unless using --form)
             batchName: opts.batchName,
             ozIn,
             roastNotes: opts.roastNotes,
+            roastTargets,
         });
         // 7. Output
         if (globalOpts.pretty) {
@@ -490,12 +503,16 @@ Required: <file> path and --coffee-id (unless using --form)
     // ── roast watch <directory> ───────────────────────────────────────────────
     roast
         .command('watch')
-        .description('Watch a directory for new .alog files and auto-import them')
+        .description('Watch a directory for new .alog files and queue or auto-import them')
         .argument('[directory]', 'Directory to watch for .alog files')
         .option('--coffee-id <id>', '[REQUIRED unless --auto-match] green_coffee_inv ID for all imports')
         .option('--batch-prefix <name>', 'Batch name prefix for auto-named batches (defaults to coffee name)')
         .option('--prompt-each', 'Prompt for bean selection on each new file (instead of using --coffee-id)')
         .option('--auto-match', 'Use AI to auto-match beans per file (mutually exclusive with --coffee-id)')
+        .option('--commit-mode <mode>', 'Commit mode: batch (default) or individual')
+        .option('--oz-in <oz>', 'Green weight in ounces for watched imports')
+        .option('--roast-notes <notes>', 'Roast notes to apply to watched imports')
+        .option('--roast-targets <targets>', 'Roast targets to apply to watched imports')
         .option('--resume', 'Resume a previous watch session from where it left off')
         .option('--form', 'Interactive form mode (prompts for directory + bean selection)')
         .addHelpText('after', `
@@ -503,19 +520,41 @@ Examples:
   purvey roast watch ~/artisan/ --coffee-id 7
   purvey roast watch ~/artisan/ --coffee-id 42 --batch-prefix "Colombia Huila"
   purvey roast watch ~/artisan/ --auto-match
+  purvey roast watch ~/artisan/ --coffee-id 7 --commit-mode individual
   purvey roast watch ~/artisan/ --prompt-each
   purvey roast watch --resume      # continue a previous session
   purvey roast watch --form        # interactive setup wizard
 
 Notes:
   Runs continuously until Ctrl+C. New .alog files detected in the directory
-  are automatically imported as roast profiles.
+  are queued or imported as roast profiles depending on commit mode.
   --auto-match and --coffee-id are mutually exclusive.
+  --commit-mode defaults to batch.
   Session state is saved for --resume.
   Requires authentication (member role).
 `)
         .action(withErrorHandling(async (directory, opts) => {
         const { supabase, userId } = await requireAuth('member');
+        const parseCommitMode = (value, fallback = 'batch') => {
+            if (value === undefined || value === null || String(value).trim() === '') {
+                return fallback;
+            }
+            const normalized = String(value).trim().toLowerCase();
+            if (normalized === 'batch' || normalized === 'individual') {
+                return normalized;
+            }
+            throw new PrvrsError('INVALID_ARGUMENT', `Invalid --commit-mode: "${value}". Use "batch" or "individual".`);
+        };
+        const parseOptionalPositiveNumber = (value, flagName) => {
+            if (value === undefined || value === null || String(value).trim() === '') {
+                return undefined;
+            }
+            const parsed = parseFloat(String(value));
+            if (isNaN(parsed) || parsed <= 0) {
+                throw new PrvrsError('INVALID_ARGUMENT', `Invalid ${flagName}: "${value}".`);
+            }
+            return parsed;
+        };
         // ── Resume mode ──────────────────────────────────────────────────────
         if (opts.resume) {
             const saved = await loadWatchSession();
@@ -526,7 +565,15 @@ Notes:
                 coffeeId: saved.coffeeId,
                 coffeeName: saved.coffeeName,
                 batchPrefix: saved.batchPrefix,
+                promptEach: Boolean(saved.promptEach),
+                autoMatch: Boolean(saved.autoMatch),
+                commitMode: saved.commitMode ?? 'batch',
+                startedAt: saved.startedAt,
+                resumeImports: saved.imports,
                 startSequence: saved.imports.length,
+                ozIn: saved.ozIn,
+                roastNotes: saved.roastNotes,
+                roastTargets: saved.roastTargets,
             });
             return;
         }
@@ -592,12 +639,56 @@ Notes:
                 });
             if (typeof promptEachRaw !== 'boolean')
                 guardCancel(promptEachRaw);
+            const commitModeRaw = await p.select({
+                message: 'Commit mode',
+                initialValue: 'batch',
+                options: [
+                    {
+                        value: 'batch',
+                        label: 'Batch commit on Ctrl+C',
+                        hint: 'Default. Queue imports and commit them together when the session ends.',
+                    },
+                    {
+                        value: 'individual',
+                        label: 'Commit each roast immediately',
+                        hint: 'Import each new file as soon as it appears.',
+                    },
+                ],
+            });
+            guardCancel(commitModeRaw);
+            const commitMode = parseCommitMode(commitModeRaw);
+            const ozInRaw = await p.text({
+                message: 'Green weight (oz)',
+                placeholder: 'optional',
+                validate: (v) => {
+                    if (!v || v.trim() === '')
+                        return;
+                    const n = parseFloat(v);
+                    if (isNaN(n) || n <= 0)
+                        return 'Must be a positive number.';
+                },
+            });
+            guardCancel(ozInRaw);
+            const roastTargetsRaw = await p.text({
+                message: 'Roast targets',
+                placeholder: 'optional',
+            });
+            guardCancel(roastTargetsRaw);
+            const roastNotesRaw = await p.text({
+                message: 'Roast notes',
+                placeholder: 'optional',
+            });
+            guardCancel(roastNotesRaw);
             await startWatch(supabase, userId, watchDir, {
                 coffeeId: watchCoffeeId,
                 coffeeName: watchCoffeeName,
                 batchPrefix,
+                commitMode,
                 promptEach: useAutoMatch ? false : Boolean(promptEachRaw),
                 autoMatch: useAutoMatch,
+                ozIn: parseOptionalPositiveNumber(ozInRaw, 'green weight'),
+                roastTargets: String(roastTargetsRaw).trim() !== '' ? String(roastTargetsRaw).trim() : undefined,
+                roastNotes: String(roastNotesRaw).trim() !== '' ? String(roastNotesRaw).trim() : undefined,
             });
             return;
         }
@@ -606,6 +697,14 @@ Notes:
             throw new PrvrsError('INVALID_ARGUMENT', 'Missing directory argument. Use --form for interactive mode or --resume to continue.');
         }
         const autoMatch = Boolean(opts.autoMatch);
+        const commitMode = parseCommitMode(opts.commitMode);
+        const ozIn = parseOptionalPositiveNumber(opts.ozIn, '--oz-in');
+        const roastNotes = typeof opts.roastNotes === 'string' && opts.roastNotes.trim() !== ''
+            ? opts.roastNotes.trim()
+            : undefined;
+        const roastTargets = typeof opts.roastTargets === 'string' && opts.roastTargets.trim() !== ''
+            ? opts.roastTargets.trim()
+            : undefined;
         // --auto-match and --coffee-id are mutually exclusive (auto-match picks the bean)
         if (autoMatch && opts.coffeeId) {
             throw new PrvrsError('INVALID_ARGUMENT', '--auto-match and --coffee-id are mutually exclusive. Use one or the other.');
@@ -644,8 +743,12 @@ Notes:
             coffeeId,
             coffeeName,
             batchPrefix,
+            commitMode,
             promptEach: Boolean(opts.promptEach),
             autoMatch,
+            ozIn,
+            roastNotes,
+            roastTargets,
         });
     }));
     return roast;