@purveyors/cli 0.9.6 → 0.15.1

package/dist/program.js

@@ -0,0 +1,135 @@
+import { Command } from 'commander';
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+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 { buildManifestCommand } from './commands/manifest.js';
+import { buildRoastCommand } from './commands/roast.js';
+import { buildSalesCommand } from './commands/sales.js';
+import { buildTastingCommand } from './commands/tasting.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+function applyProcessBoundarySettings(command) {
+    command.configureOutput({
+        outputError: () => {
+            // Route Commander parse failures through the top-level fatal() contract
+            // instead of printing raw stderr before exitOverride throws.
+        },
+    });
+    command.exitOverride((error) => {
+        if (error.exitCode === 0) {
+            process.exit(0);
+        }
+        throw error;
+    });
+    for (const subcommand of command.commands) {
+        applyProcessBoundarySettings(subcommand);
+    }
+}
+export function getCliVersion() {
+    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
+    }
+    return version;
+}
+export function createProgram(version = getCliVersion()) {
+    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 (viewer role required, authentication needed):
+  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
+
+Local and reference commands (no pre-existing session required):
+  config list       Show all config values
+  config get        Get a config value
+  config set        Set a config value
+  config reset      Reset config to defaults
+  context           Output the dense human-readable operator reference; use --json/--pretty only for manifest parity
+  manifest          Output the preferred stable machine-readable CLI contract for agents/scripts
+
+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 7
+  $ purvey roast watch ~/artisan/ --auto-match
+  $ purvey tasting rate 42 --aroma 4 --body 3 --acidity 5 --sweetness 4 --aftertaste 4
+  $ purvey --help
+  $ purvey context
+  $ purvey manifest
+  $ purvey manifest --pretty
+  $ purvey context --json > cli-manifest.json
+
+CLI docs:            https://purveyors.io/docs/cli/overview
+API docs:            https://purveyors.io/docs/api/overview
+Repository:          https://github.com/reedwhetstone/purveyors-cli
+npm package:         https://www.npmjs.com/package/@purveyors/cli
+Quick discovery:  purvey --help
+Human reference:  purvey context
+JSON manifest:    purvey manifest
+Module import:    @purveyors/cli/manifest
+`);
+    program.addCommand(buildAuthCommand());
+    program.addCommand(buildCatalogCommand());
+    program.addCommand(buildConfigCommand());
+    program.addCommand(buildContextCommand());
+    program.addCommand(buildInventoryCommand());
+    program.addCommand(buildManifestCommand());
+    program.addCommand(buildRoastCommand());
+    program.addCommand(buildSalesCommand());
+    program.addCommand(buildTastingCommand());
+    applyProcessBoundarySettings(program);
+    return program;
+}
+//# sourceMappingURL=program.js.map

package/dist/program.js.map

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

package/dist/types/index.d.ts

@@ -26,4 +26,8 @@ export interface CliError {
     message: string;
     details?: unknown;
 }
+export interface CliErrorEnvelope extends CliError {
+    error: true;
+    exitCode: number;
+}
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAiB,SAAQ,QAAQ;IAChD,KAAK,EAAE,IAAI,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@purveyors/cli",
-  "version": "0.9.6",
+  "version": "0.15.1",
   "description": "The official CLI for purveyors.io — coffee intelligence from your terminal",
   "type": "module",
   "bin": {
@@ -14,6 +14,7 @@
     "./sales": "./dist/lib/sales.js",
     "./tasting": "./dist/lib/tasting.js",
     "./lib": "./dist/lib/index.js",
+    "./manifest": "./dist/lib/manifest.js",
     "./artisan": "./dist/lib/artisan/index.js",
     "./ai": "./dist/lib/ai.js"
   },
@@ -38,11 +39,16 @@
   "author": "Reed Whetstone",
   "license": "SEE LICENSE IN LICENSE.md",
   "scripts": {
+    "clean:dist": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
     "build": "tsc",
     "dev": "tsx src/index.ts",
     "lint": "prettier --check . && eslint .",
     "format": "prettier --write .",
     "check": "tsc --noEmit",
+    "verify:contract": "vitest run tests/manifest.test.ts tests/cli-output-modes.test.ts",
+    "verify:dist": "vitest run tests/dist-contract.test.ts",
+    "verify:prepublish": "pnpm clean:dist && pnpm build && pnpm verify:contract && pnpm verify:dist && node scripts/verify-prepublish-parity.mjs",
+    "prepack": "pnpm verify:prepublish",
     "test": "vitest run",
     "test:watch": "vitest"
   },