@purveyors/cli 0.9.6 → 0.14.0

package/dist/commands/config.js

@@ -1,8 +1,23 @@
 import { Command } from 'commander';
 import { withErrorHandling, PrvrsError } from '../lib/errors.js';
-import { readConfig, writeConfig, getConfigValue, setConfigValue, isValidConfigKey, } from '../lib/config.js';
-import { success, info } from '../lib/output.js';
+import { readConfig, writeConfig, setConfigValue, isValidConfigKey } from '../lib/config.js';
+import { outputData, shouldUseInteractiveOutput, success, info } from '../lib/output.js';
 // ─── Command builder ──────────────────────────────────────────────────────────
+function resolveConfigOutput(cmd) {
+    const outputOptions = cmd.optsWithGlobals();
+    if (outputOptions.csv) {
+        throw new PrvrsError('INVALID_ARGUMENT', 'The config commands do not support --csv. Use text, --json, or --pretty.');
+    }
+    return {
+        outputOptions,
+        isInteractive: shouldUseInteractiveOutput(outputOptions),
+    };
+}
+function configValuePayload(key, value) {
+    return {
+        [key]: value ?? null,
+    };
+}
 /**
  * `purvey config` — Manage purvey CLI settings.
  * Config is stored in ~/.config/purvey/config.json.
@@ -19,11 +34,18 @@ Examples:
 
 Notes:
   Config is stored at ~/.config/purvey/config.json.
-  Shows all key = value pairs currently set.
+  Interactive terminals show human-readable key = value lines.
+  --json / --pretty, or any non-interactive use, emits the config object on stdout.
+  --csv is not supported.
 `)
-        .action(withErrorHandling(async () => {
+        .action(withErrorHandling(async (_, cmd) => {
+        const { outputOptions, isInteractive } = resolveConfigOutput(cmd);
         const cfg = await readConfig();
         const keys = Object.keys(cfg);
+        if (!isInteractive) {
+            outputData(cfg, outputOptions);
+            return;
+        }
         if (keys.length === 0) {
             info('No config values set. Use `purvey config set <key> <value>` to configure.');
             return;
@@ -46,19 +68,27 @@ Supported keys:
   form-mode   true/false — auto-enter interactive wizard when required args are missing
 
 Notes:
-  Prints the raw value to stdout (no decorators), suitable for scripting.
-  Prints "form-mode is not set." if the key has no value.
+  Interactive terminals print the raw value to stdout with no decorators.
+  --json / --pretty, or any non-interactive use, emits {"<key>": value|null}.
+  Prints "form-mode is not set." interactively if the key has no value.
+  --csv is not supported.
 `)
-        .action(withErrorHandling(async (key) => {
+        .action(withErrorHandling(async (key, _opts, cmd) => {
         if (!isValidConfigKey(key)) {
             throw new PrvrsError('INVALID_ARGUMENT', `Unknown config key: "${key}". Valid keys: form-mode.`);
         }
-        const value = await getConfigValue(key);
+        const { outputOptions, isInteractive } = resolveConfigOutput(cmd);
+        const cfg = await readConfig();
+        const value = cfg[key];
+        if (!isInteractive) {
+            outputData(configValuePayload(key, value), outputOptions);
+            return;
+        }
         if (value === undefined) {
             info(`${key} is not set.`);
         }
         else {
-            console.log(value);
+            console.log(String(value));
         }
     }));
     // ── config set <key> <value> ──────────────────────────────────────────────
@@ -74,18 +104,29 @@ Examples:
   $ purvey config set form-mode true
   $ purvey config set form-mode false
   $ purvey config get form-mode
-  $ purvey config list
+  $ purvey config set form-mode true --json
+
+Notes:
+  Interactive terminals print a human-readable success line.
+  --json / --pretty, or any non-interactive use, emits the updated config value.
+  --csv is not supported.
 `)
-        .action(withErrorHandling(async (key, value) => {
+        .action(withErrorHandling(async (key, value, _opts, cmd) => {
         if (!isValidConfigKey(key)) {
             throw new PrvrsError('INVALID_ARGUMENT', `Unknown config key: "${key}". Valid keys: form-mode.`);
         }
+        const { outputOptions, isInteractive } = resolveConfigOutput(cmd);
         try {
             await setConfigValue(key, value);
         }
         catch (err) {
             throw new PrvrsError('INVALID_ARGUMENT', err instanceof Error ? err.message : String(err));
         }
+        const cfg = await readConfig();
+        if (!isInteractive) {
+            outputData(configValuePayload(key, cfg[key]), outputOptions);
+            return;
+        }
         success(`Config updated: ${key} = ${value}`);
     }));
     // ── config reset ──────────────────────────────────────────────────────────
@@ -98,9 +139,17 @@ Examples:
 
 Notes:
   Clears all config values. Equivalent to deleting ~/.config/purvey/config.json.
+  Interactive terminals print a human-readable success line.
+  --json / --pretty, or any non-interactive use, emits {}.
+  --csv is not supported.
 `)
-        .action(withErrorHandling(async () => {
+        .action(withErrorHandling(async (_, cmd) => {
+        const { outputOptions, isInteractive } = resolveConfigOutput(cmd);
         await writeConfig({});
+        if (!isInteractive) {
+            outputData({}, outputOptions);
+            return;
+        }
         success('Config reset to defaults.');
     }));
     return config;

package/dist/commands/config.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyOpC,wBAAgB,mBAAmB,IAAI,OAAO,CAe7C"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,mBAAmB,IAAI,OAAO,CAkD7C"}

package/dist/commands/context.js

@@ -1,244 +1,42 @@
 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 CLI reference, or the JSON manifest with --json/--pretty')
+        .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 dense human-readable reference text.
+Use --json or --pretty for the same machine-readable manifest emitted by \`purvey manifest\`.
+
 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,0FAA0F,CAC3F;SACA,MAAM,CAAC,QAAQ,EAAE,6DAA6D,CAAC;SAC/E,MAAM,CAAC,UAAU,EAAE,8DAA8D,CAAC;SAClF,WAAW,CACV,OAAO,EACP;;;;;;;;;;;CAWL,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,CAgC9C"}

package/dist/commands/manifest.js

@@ -0,0 +1,28 @@
+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 machine-readable CLI manifest contract')
+        .option('--json', 'Emit the manifest as compact JSON (default)')
+        .option('--pretty', 'Emit the manifest as indented JSON')
+        .addHelpText('after', `
+Examples:
+  purvey manifest
+  purvey manifest --pretty
+  purvey manifest > cli-manifest.json
+  purvey manifest | jq '.commandGroups[].name'
+`)
+        .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,CAAC,mDAAmD,CAAC;SAChE,MAAM,CAAC,QAAQ,EAAE,6CAA6C,CAAC;SAC/D,MAAM,CAAC,UAAU,EAAE,oCAAoC,CAAC;SACxD,WAAW,CACV,OAAO,EACP;;;;;;CAML,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/index.js

@@ -1,108 +1,9 @@
 #!/usr/bin/env node
-import { Command } from 'commander';
-import { buildAuthCommand } from './commands/auth.js';
-import { buildCatalogCommand } from './commands/catalog.js';
-import { buildConfigCommand } from './commands/config.js';
-import { buildContextCommand } from './commands/context.js';
-import { buildInventoryCommand } from './commands/inventory.js';
-import { buildRoastCommand } from './commands/roast.js';
-import { buildSalesCommand } from './commands/sales.js';
-import { buildTastingCommand } from './commands/tasting.js';
-import { readFileSync } from 'fs';
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-// Read version from package.json at runtime
-let version = '0.0.1';
-try {
-    const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
-    version = pkg.version ?? version;
-}
-catch {
-    // Fallback to hardcoded version
-}
-const program = new Command();
-program
-    .name('purvey')
-    .description('The official CLI for purveyors.io. Coffee intelligence from your terminal')
-    .version(version, '-v, --version', 'Print version')
-    .option('--json', 'Output compact JSON explicitly (same as the default)')
-    .option('--pretty', 'Pretty-print JSON output with colors')
-    .option('--csv', 'Output results as CSV where supported')
-    .addHelpText('after', `
-Authentication:
-  auth login        Log in to purveyors.io (--headless for agents)
-  auth status       Show current login status and role
-  auth logout       Clear stored credentials
-
-Catalog (authenticated viewer session required):
-  catalog search    Search the coffee catalog with filters
-  catalog get       Get details for a specific coffee by ID
-  catalog stats     Aggregate statistics for the catalog
-  catalog similar   Find similar coffees by catalog ID
-
-Personal Data (member role required):
-  inventory list    List your green coffee inventory
-  inventory get     Get a single inventory item
-  inventory add     Add a bean to your inventory
-  inventory update  Update an inventory item
-  inventory delete  Delete an inventory item
-  roast list        List your roast profiles
-  roast get         Get a single roast profile
-  roast create      Create a new roast profile
-  roast update      Update a roast profile
-  roast delete      Delete a roast profile
-  roast import      Import an Artisan .alog roast file
-  roast watch       Watch a directory for new .alog files
-  sales list        List your sales records
-  sales record      Record a new sale
-  sales update      Update a sale record
-  sales delete      Delete a sale record
-  tasting get       Get tasting notes for a coffee
-  tasting rate      Rate a coffee bean with cupping scores
-
-Configuration:
-  config list       Show all config values
-  config get        Get a config value
-  config set        Set a config value
-  config reset      Reset config to defaults
-
-Agent Tools:
-  context           Output the dense CLI reference for agents
-
-Global Options:
-  --json            Output compact JSON explicitly
-  --pretty          Pretty-print JSON output
-  --csv             Output array results as CSV where supported
-  --help            Show help for any command
-  --version         Show version number
-
-Examples:
-  $ purvey auth login --headless
-  $ purvey catalog search --origin "Ethiopia" --process "natural" --pretty
-  $ purvey catalog similar 1182 --threshold 0.85 --stocked-only --json | jq '.[0]'
-  $ purvey inventory list --stocked --pretty
-  $ purvey roast import my-roast.alog --coffee-id 128
-  $ purvey roast watch ~/artisan/ --auto-match
-  $ purvey tasting rate 42 --aroma 4 --body 3 --acidity 5 --sweetness 4 --aftertaste 4
-  $ purvey context
-
-Documentation: https://github.com/reedwhetstone/purveyors-cli
-Agent reference: purvey context
-`);
-// Register subcommands
-program.addCommand(buildAuthCommand());
-program.addCommand(buildCatalogCommand());
-program.addCommand(buildConfigCommand());
-program.addCommand(buildContextCommand());
-program.addCommand(buildInventoryCommand());
-program.addCommand(buildRoastCommand());
-program.addCommand(buildSalesCommand());
-program.addCommand(buildTastingCommand());
-// Parse and dispatch
-program.parseAsync(process.argv).catch((err) => {
-    console.error(err instanceof Error ? err.message : String(err));
-    process.exit(1);
+import { fatal } from './lib/errors.js';
+import { createProgram } from './program.js';
+createProgram()
+    .parseAsync(process.argv)
+    .catch((err) => {
+    fatal(err);
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAErC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,4CAA4C;AAC5C,IAAI,OAAO,GAAG,OAAO,CAAC;AACtB,IAAI,CAAC;IACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACrF,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;AACnC,CAAC;AAAC,MAAM,CAAC;IACP,gCAAgC;AAClC,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,2EAA2E,CAAC;KACxF,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,eAAe,CAAC;KAClD,MAAM,CAAC,QAAQ,EAAE,sDAAsD,CAAC;KACxE,MAAM,CAAC,UAAU,EAAE,sCAAsC,CAAC;KAC1D,MAAM,CAAC,OAAO,EAAE,uCAAuC,CAAC;KACxD,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4DH,CACE,CAAC;AAEJ,uBAAuB;AACvB,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;AACvC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAC1C,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;AACzC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAC1C,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;AAC5C,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;AACxC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;AACxC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAE1C,qBAAqB;AACrB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACtD,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,aAAa,EAAE;KACZ,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC;KACxB,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACtB,KAAK,CAAC,GAAG,CAAC,CAAC;AACb,CAAC,CAAC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,QAAA,MAAM,UAAU,QAAuC,CAAC;AACxD,QAAA,MAAM,gBAAgB,QAAuC,CAAC;AAS9D,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,4DAA4D;AAC5D,QAAA,MAAM,WAAW,wBAAyB,CAAC;AAC3C,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,SAAS,CAE9D;AAID;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAErD;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAqBzE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG9E;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMvD;AAID;;;GAGG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC,CAQxD;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAM7E;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAe9E;AAED,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,QAAA,MAAM,UAAU,QAAuC,CAAC;AACxD,QAAA,MAAM,gBAAgB,QAAuC,CAAC;AAS9D,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,4DAA4D;AAC5D,QAAA,MAAM,WAAW,wBAAyB,CAAC;AAC3C,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,SAAS,CAE9D;AAID;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAErD;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAqBzE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG9E;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMvD;AAID;;;GAGG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC,CAaxD;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAM7E;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAe9E;AAED,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/lib/config.js

@@ -2,6 +2,7 @@ import { homedir } from 'os';
 import { join } from 'path';
 import { mkdir, readFile, writeFile, unlink, access } from 'fs/promises';
 import { constants } from 'fs';
+import { ConfigError } from './errors.js';
 const CONFIG_DIR = join(homedir(), '.config', 'purvey');
 const CREDENTIALS_FILE = join(CONFIG_DIR, 'credentials.json');
 const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
@@ -74,12 +75,17 @@ export async function deleteCredentials() {
 export async function readConfig() {
     try {
         await access(CONFIG_FILE, constants.R_OK);
-        const raw = await readFile(CONFIG_FILE, 'utf-8');
-        return JSON.parse(raw);
     }
     catch {
         return {};
     }
+    try {
+        const raw = await readFile(CONFIG_FILE, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        throw new ConfigError(`Config file is invalid or unreadable: ${CONFIG_FILE}.`, error);
+    }
 }
 /**
  * Write the purvey app config to ~/.config/purvey/config.json.

package/dist/lib/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAE/B,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AACxD,MAAM,gBAAgB,GAAG,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;AAC9D,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEpD,iDAAiD;AACjD,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAC9D,MAAM,uBAAuB,GAAG,IAAI,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;AAQ5E,4DAA4D;AAC5D,MAAM,WAAW,GAAG,CAAC,WAAW,CAAU,CAAC;AAG3C,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAQ,WAAiC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,gBAAgB,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;QACvE,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,uBAAuB,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC;YAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;YACnD,sBAAsB;YACtB,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;YAC9B,kCAAkC;YAClC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YAC3D,MAAM,UAAU,CAAC,uBAAuB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAC1D,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAwB;IAC7D,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,SAAS,CAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACrF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;IAC/B,CAAC;AACH,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,WAAW,CAAC,yCAAyC,WAAW,GAAG,EAAE,KAAK,CAAC,CAAC;IACxF,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAoB;IACpD,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACxF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAgB,CAAC,CAAC;IACvC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,KAAa;IAC7D,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,kBAAkB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1F,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAElC,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;QACxB,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,CAAC,WAAW,CAAC,GAAG,KAAK,KAAK,MAAM,CAAC;IACzC,CAAC;IAED,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC"}