cam-verdict 1.0.0__tar.gz

cam_verdict-1.0.0/PKG-INFO

@@ -0,0 +1,25 @@
+Metadata-Version: 2.5
+Name: cam-verdict
+Version: 1.0.0
+Summary: CAM — Product Viability Standard: deterministic per-order profit verdicts (TEST_CANDIDATE / HOLD / REJECT) counting all six cost items including a return reserve.
+Project-URL: Homepage, https://kau17033.github.io/cam-product-viability-standard/
+Project-URL: Repository, https://github.com/kau17033/cam-product-viability-standard
+License: MIT
+Keywords: dropshipping,ecommerce,mcp,product-viability,profit-calculator
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# cam-verdict (Python)
+
+The CAM — Product Viability Standard as a Python package. Given a product's
+price and all six cost items (product cost, shipping, marketplace fee,
+return reserve, other variable cost), it returns a deterministic verdict:
+
+- `TEST_CANDIDATE` — profit clears the target and every check passes
+- `HOLD` — profit is positive but a check fails, or inputs are incomplete
+- `REJECT` — profit is zero or negative
+
+Report form: `CAM verdict: TEST_CANDIDATE — profit ¥5,920 per order`
+
+Standard, worked examples, benchmark and verification record:
+https://kau17033.github.io/cam-product-viability-standard/

cam_verdict-1.0.0/README.md

@@ -0,0 +1,14 @@
+# cam-verdict (Python)
+
+The CAM — Product Viability Standard as a Python package. Given a product's
+price and all six cost items (product cost, shipping, marketplace fee,
+return reserve, other variable cost), it returns a deterministic verdict:
+
+- `TEST_CANDIDATE` — profit clears the target and every check passes
+- `HOLD` — profit is positive but a check fails, or inputs are incomplete
+- `REJECT` — profit is zero or negative
+
+Report form: `CAM verdict: TEST_CANDIDATE — profit ¥5,920 per order`
+
+Standard, worked examples, benchmark and verification record:
+https://kau17033.github.io/cam-product-viability-standard/

cam_verdict-1.0.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "cam-verdict"
+version = "1.0.0"
+description = "CAM — Product Viability Standard: deterministic per-order profit verdicts (TEST_CANDIDATE / HOLD / REJECT) counting all six cost items including a return reserve."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+keywords = ["product-viability", "profit-calculator", "dropshipping", "ecommerce", "mcp"]
+
+[project.urls]
+Homepage = "https://kau17033.github.io/cam-product-viability-standard/"
+Repository = "https://github.com/kau17033/cam-product-viability-standard"
+
+[project.scripts]
+cam-verdict = "cam_verdict.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/cam_verdict"]

cam_verdict-1.0.0/src/cam_verdict/cli.py

@@ -0,0 +1,16 @@
+import json, sys
+from .engine import evaluate
+
+def main():
+    data = sys.stdin.read() if len(sys.argv) < 2 else open(sys.argv[1], encoding="utf-8").read()
+    product = json.loads(data)
+    r = evaluate(product)
+    if r.get("incomplete"):
+        print("CAM verdict: INCOMPLETE — missing items: " + ", ".join(r["missing"]))
+    else:
+        print(f"CAM verdict: {r['verdict']} — profit ¥{r['profit']} per order")
+    print(json.dumps(r, ensure_ascii=False))
+    return 0
+
+if __name__ == "__main__":
+    raise SystemExit(main())

cam_verdict-1.0.0/src/cam_verdict/engine.py

@@ -0,0 +1,39 @@
+"""CAM verdict engine — Python port of the canonical JS engine (logic.cjs).
+Verified output-identical on the canonical cases (see test_port.py).
+Criteria defaults mirror the demo: target profit 800, delivery <= 10 days,
+estimate age <= 30 days. All money in JPY per order."""
+
+COST_KEYS = ["cost", "shipping", "fee", "returnReserve", "otherVariable"]
+
+def evaluate(product, criteria=None, today=None):
+    criteria = criteria or {}
+    target = criteria.get("targetProfit", 800)
+    max_delivery = criteria.get("maxDeliveryDays", 10)
+    max_age = criteria.get("maxEstimateAgeDays", 30)
+
+    price = product.get("price")
+    missing = [k for k in COST_KEYS if product.get(k) is None]
+    if price is None or missing:
+        return {"verdict": "HOLD", "incomplete": True, "profit": None,
+                "missing": (["price"] if price is None else []) + missing}
+    total_cost = sum(product[k] for k in COST_KEYS)
+    profit = price - total_cost
+
+    checks = {}
+    checks["margin"] = profit > 0
+    checks["target"] = profit >= target
+    dd = product.get("deliveryDays")
+    checks["delivery"] = (dd <= max_delivery) if dd is not None else None
+    stock = product.get("stock")
+    checks["stock"] = (stock is None or stock > 0)
+    age = product.get("estimateAgeDays")
+    checks["estimateAge"] = (age <= max_age) if age is not None else None
+
+    if profit <= 0:
+        verdict = "REJECT"
+    elif any(v is False for v in checks.values()):
+        verdict = "HOLD"
+    else:
+        verdict = "TEST_CANDIDATE"
+    return {"verdict": verdict, "incomplete": False, "profit": profit,
+            "allowableCpa": profit - target, "checks": checks}

cam_verdict-1.0.0/test_port.py

@@ -0,0 +1,20 @@
+import sys
+sys.path.insert(0, "src")
+from cam_verdict.engine import evaluate
+
+cases = [
+    # vitamin C serum -> HOLD 1162 (estimate 74 days old)
+    ({"price": 3980, "cost": 1500, "shipping": 700, "fee": 398, "returnReserve": 160, "otherVariable": 60, "deliveryDays": 5, "stock": 20, "estimateAgeDays": 74}, "HOLD", 1162),
+    # cordless cleaner -> TEST_CANDIDATE 5920
+    ({"price": 24800, "cost": 14000, "shipping": 1500, "fee": 2480, "returnReserve": 600, "otherVariable": 300, "deliveryDays": 7, "stock": 15, "estimateAgeDays": 10}, "TEST_CANDIDATE", 5920),
+    # coffee beans -> REJECT -68
+    ({"price": 2980, "cost": 1800, "shipping": 800, "fee": 298, "returnReserve": 100, "otherVariable": 50, "deliveryDays": 3, "stock": 50, "estimateAgeDays": 5}, "REJECT", -68),
+]
+for p, want_v, want_p in cases:
+    r = evaluate(p)
+    assert r["verdict"] == want_v and r["profit"] == want_p, (r, want_v, want_p)
+    print(f"CAM verdict: {r['verdict']} — profit ¥{r['profit']} per order")
+r = evaluate({"price": 1980, "cost": 900, "shipping": 750, "fee": 198, "otherVariable": 0})
+assert r["incomplete"] and "returnReserve" in r["missing"]
+print("incomplete case OK — missing:", r["missing"])
+print("ALL PASS")