cardworthscanner-cli 0.0.0-stage → 1.0.1

package/README.md

@@ -1,3 +1,24 @@
-# Temporary Holding Version
+# CardWorthScanner CLI
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Official command-line companion for **[CardWorthScanner.com](https://cardworthscanner.com)** — The premier analytics and deterministic valuation suite for Pokemon, Magic: The Gathering (MTG), Yu-Gi-Oh!, and sports card collectors.
+
+## Quick Start
+
+Run instantly with `npx` (no installation needed):
+
+```bash
+# Calculate trading card border centering ratio (PSA 10 55/45 benchmark)
+npx cardworthscanner-cli centering --left 52 --right 48 --top 50 --bottom 50
+
+# Calculate PSA grading ROI and net profit after marketplace fees
+npx cardworthscanner-cli roi --raw 50 --grade 25 --gem 300 --mint 100
+
+# Open the full web workbench
+npx cardworthscanner-cli open
+```
+
+## Features
+
+- **Centering Ratio Verification**: Instant pixel/mm border math checking against PSA 10 (55/45) and BGS 9.5 (50/50) standards.
+- **Grading Economics**: Fast calculation of upfront card costs, third-party authentication fees, expected PSA 10/9 sales comps, and net return on investment.
+- **Web Workbench**: Seamless launch into the full interactive camera scanner and portfolio trackers at [CardWorthScanner.com](https://cardworthscanner.com).

package/bin/cardworthscanner.mjs

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+
+const args = process.argv.slice(2);
+const command = args[0] || 'help';
+
+console.log('🃏 CardWorthScanner CLI v1.0.1 — PSA/BGS Card Grading & Valuation Engine');
+console.log('🌐 Web Workbench: https://cardworthscanner.com\n');
+
+if (command === 'help' || command === '--help' || command === '-h') {
+  console.log(`Usage:
+  npx cardworthscanner-cli centering --left <px> --right <px> --top <px> --bottom <px>
+  npx cardworthscanner-cli roi --raw <cost> --grade <fee> --gem <price> [--mint <price>]
+  npx cardworthscanner-cli open
+
+Examples:
+  npx cardworthscanner-cli centering --left 52 --right 48 --top 50 --bottom 50
+  npx cardworthscanner-cli roi --raw 50 --grade 25 --gem 300 --mint 100
+  npx cardworthscanner-cli open
+`);
+  process.exit(0);
+}
+
+if (command === 'open') {
+  const url = 'https://cardworthscanner.com';
+  console.log(`Opening CardWorthScanner Web App: ${url}`);
+  const openCmd = process.platform === 'win32' ? `start ${url}` : process.platform === 'darwin' ? `open ${url}` : `xdg-open ${url}`;
+  import('node:child_process').then(({ exec }) => exec(openCmd));
+  process.exit(0);
+}
+
+if (command === 'centering') {
+  const getArg = (flag) => {
+    const idx = args.indexOf(flag);
+    return idx !== -1 && args[idx + 1] ? parseFloat(args[idx + 1]) : null;
+  };
+  const left = getArg('--left') ?? 50;
+  const right = getArg('--right') ?? 50;
+  const top = getArg('--top') ?? 50;
+  const bottom = getArg('--bottom') ?? 50;
+
+  const lrTotal = left + right;
+  const tbTotal = top + bottom;
+
+  const lrPct1 = Math.round((Math.max(left, right) / lrTotal) * 100);
+  const lrPct2 = 100 - lrPct1;
+  const tbPct1 = Math.round((Math.max(top, bottom) / tbTotal) * 100);
+  const tbPct2 = 100 - tbPct1;
+
+  console.log(`📐 Centering Measurements:`);
+  console.log(`   Left/Right Ratio : ${lrPct1}/${lrPct2}%`);
+  console.log(`   Top/Bottom Ratio : ${tbPct1}/${tbPct2}%`);
+
+  const meetsPsa10Front = lrPct1 <= 55 && tbPct1 <= 55;
+  const meetsBgs95 = lrPct1 <= 50.5 && tbPct1 <= 50.5;
+
+  console.log(`\n🏆 Centering Verdicts:`);
+  console.log(`   PSA 10 Gem Mint Standard (55/45 or better) : ${meetsPsa10Front ? '✅ PASS' : '❌ FAIL (Outside 55/45)'}`);
+  console.log(`   BGS 9.5 True Gem Standard (50/50)           : ${meetsBgs95 ? '✅ PASS' : '⚠️ SIGHT VARIANCE'}`);
+  console.log(`\nExplore full AI visual border scanner at https://cardworthscanner.com/centering-calculator`);
+  process.exit(0);
+}
+
+if (command === 'roi') {
+  const getArg = (flag) => {
+    const idx = args.indexOf(flag);
+    return idx !== -1 && args[idx + 1] ? parseFloat(args[idx + 1]) : 0;
+  };
+  const raw = getArg('--raw') || 50;
+  const grade = getArg('--grade') || 25;
+  const gem = getArg('--gem') || 300;
+  const mint = getArg('--mint') || 80;
+
+  const totalCost = raw + grade;
+  const netGem = gem * (1 - 0.125);
+  const profitGem = netGem - totalCost;
+  const roiGem = Math.round((profitGem / totalCost) * 100);
+
+  const netMint = mint * (1 - 0.125);
+  const profitMint = netMint - totalCost;
+
+  console.log(`💰 Grading Economics:`);
+  console.log(`   Total Upfront Cost (Raw + Fee) : $${totalCost.toFixed(2)}`);
+  console.log(`   PSA 10 (Gem Mint) Gross Price  : $${gem.toFixed(2)}`);
+  console.log(`   Net Profit on PSA 10           : $${profitGem.toFixed(2)} (ROI: ${roiGem}%)`);
+  console.log(`   Net Profit/Loss on PSA 9       : $${profitMint.toFixed(2)}`);
+
+  console.log(`\nRun full multi-tier portfolio simulations at https://cardworthscanner.com/psa-grading-calculator`);
+  process.exit(0);
+}
+
+console.log(`Unknown command: "${command}". Run "npx cardworthscanner-cli help" for usage.`);

package/package.json

@@ -1,6 +1,32 @@
 {
   "name": "cardworthscanner-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "Trading card grading ROI calculator, optical centering inspector, and TCG market price scanner CLI for CardWorthScanner.com.",
+  "main": "bin/cardworthscanner.mjs",
+  "bin": {
+    "cardworthscanner": "bin/cardworthscanner.mjs",
+    "cardworthscanner-cli": "bin/cardworthscanner.mjs"
+  },
+  "type": "module",
+  "keywords": [
+    "cardworthscanner",
+    "card-worth",
+    "psa-grading",
+    "tcgplayer",
+    "card-centering",
+    "pokemon-cards",
+    "sports-cards",
+    "bgs",
+    "cgc"
+  ],
+  "author": "Abigail Davised",
+  "license": "MIT",
+  "homepage": "https://cardworthscanner.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AbigailDavised/cardworthscanner-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/AbigailDavised/cardworthscanner-mcp/issues"
+  }
+}