slab-cli 0.19.0__tar.gz → 0.20.0__tar.gz

{slab_cli-0.19.0 → slab_cli-0.20.0}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.3
 Name: slab-cli
-Version: 0.19.0
+Version: 0.20.0
 Summary: CLI for the slab trading-card API — catalog, collect, and track your cards from the terminal.
 Author: dev_jeb
-Requires-Dist: slab-schemas>=0.34.0
+Requires-Dist: slab-schemas>=0.35.0
 Requires-Dist: httpx>=0.27
 Requires-Dist: rich>=13.0
 Requires-Dist: inquirerpy>=0.3

{slab_cli-0.19.0 → slab_cli-0.20.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "slab-cli"
-version = "0.19.0"
+version = "0.20.0"
 description = "CLI for the slab trading-card API — catalog, collect, and track your cards from the terminal."
 readme = "README.md"
 authors = [{name = "dev_jeb"}]
@@ -11,7 +11,8 @@ dependencies = [
     # grading-desk models `slab card grade` / `slab collection grade` parse responses into.
     # 0.34 reframes the grading desk from verdicts to break-even readings (BreakEvenRegion,
     # GradingDesk.break_even) — the desk shows data, never tells the user to grade.
-    "slab-schemas>=0.34.0",
+    # 0.35 adds Liquidity/LiquidityLabel, which the market view's Sells column renders.
+    "slab-schemas>=0.35.0",
     "httpx>=0.27",
     "rich>=13.0",
     "InquirerPy>=0.3",

{slab_cli-0.19.0 → slab_cli-0.20.0}/src/slab_cli/display.py

@@ -20,7 +20,8 @@ from slab_schemas.community import (
 from slab_schemas.custom_sets import CustomSetDetail, CustomSetOut, CustomSetSearchResult
 from slab_schemas.dashboard import CatalogStats, DashboardStats, HighlightCard, LabeledCount
 from slab_schemas.grading_desk import CollectionGradingDesk, GradingDesk
-from slab_schemas.enums import BreakEvenRegion, Grade, SealedFormat
+from slab_schemas.enums import BreakEvenRegion, Grade, LiquidityLabel, SealedFormat
+from slab_schemas.liquidity import Liquidity
 from slab_schemas.pricing import CardComps, CardMarket, PortfolioSummary, SetTopCards
 from slab_schemas.sealed import SealedPriceHistory, SealedProductOut
 from slab_schemas.timeseries import CardPriceHistory
@@ -971,7 +972,8 @@ def render_card_market(m: CardMarket) -> None:
 
     # The Δ columns are FMV (appraisal) drift, not the window's sales — FMV smooths 90 days of
     # comps, so these lag the live market (two-lane rule, CLAUDE.md). Headers say FMV so a
-    # "+$5" cell reads as the appraisal moving, not as last week's market.
+    # "+$5" cell reads as the appraisal moving, not as last week's market. "Sells" is the other
+    # lane: real sale cadence from comps (liquidity), so the price and its pace sit side by side.
     table = slab_table([
         ("Grade", {"style": "slab.value"}),
         ("FMV", {"justify": "right"}),
@@ -979,6 +981,7 @@ def render_card_market(m: CardMarket) -> None:
         ("FMV Δ7d", {"justify": "right"}),
         ("FMV Δ30d", {"justify": "right"}),
         ("Comps", {"justify": "right", "style": "slab.dim"}),
+        ("Sells", {"style": "slab.dim"}),
     ])
 
     for pp in sorted(m.price_points, key=lambda p: (p.finish or "", p.grade_key)):
@@ -990,14 +993,39 @@ def render_card_market(m: CardMarket) -> None:
         if pp.price_low is not None and pp.price_high is not None:
             rng = f"${pp.price_low:,.0f} – ${pp.price_high:,.0f}"
         table.add_row(label, fmv, rng, signed_money(pp.price_change_7d),
-                      signed_money(pp.price_change_30d), str(pp.sample_size))
+                      signed_money(pp.price_change_30d), str(pp.sample_size),
+                      _liquidity_text(pp.liquidity))
 
     window = m.price_points[0].window_days
     console.print(heading("Market Price", f"{window}-day window, as of {m.as_of_date}"))
     console.print(table)
+    if any(pp.liquidity for pp in m.price_points):
+        console.print(
+            "  [slab.dim]Sells = how often this exact printing and grade actually sells — the "
+            "typical gap between real sales in the last 90 days, or the past year's count for "
+            "slow movers. A rare seller isn't bad; it means the price is an estimate you may "
+            "wait to realize.[/]"
+        )
     console.print()
 
 
+def _liquidity_text(liq: Liquidity | None) -> str:
+    """A liquidity reading as one short table cell — the pace, then the datum behind it.
+    Data statements only, mirroring the `liquidity.*` glossary."""
+    if liq is None:
+        return "—"
+    L = LiquidityLabel
+    if liq.median_days_between_sales is not None:
+        gap = liq.median_days_between_sales
+        word = {L.sells_daily: "~daily", L.sells_weekly: "~weekly"}.get(liq.label, "~monthly")
+        return f"{word} (every {gap}d)" if gap > 0 else f"{word} (several/day)"
+    if liq.label == L.too_new_to_say:
+        return f"too new to say ({liq.observed_days}d watched)"
+    if liq.label == L.no_recent_sales:
+        return "none this year"
+    return f"{liq.sales_365d}×/year"
+
+
 def _format_label(fmt: str) -> str:
     """SealedFormat value -> display label: hobby_box -> Hobby Box."""
     return fmt.replace("_", " ").title()
@@ -1201,15 +1229,21 @@ def render_grading_desk(d: GradingDesk) -> None:
             ("Sells for", {"justify": "right", "style": "slab.foil"}),
             ("You clear", {"justify": "right"}),
             ("Sales", {"justify": "right", "style": "slab.dim"}),
+            ("Sells", {"style": "slab.dim"}),
         ])
         for l in d.lanes:
             n = f"{l.sample_size}!" if l.low_confidence else str(l.sample_size)
-            table.add_row(l.grade_key, money(l.fair_market_value), signed_money(l.payoff), n)
+            table.add_row(l.grade_key, money(l.fair_market_value), signed_money(l.payoff), n,
+                          _liquidity_text(l.liquidity))
         console.print(heading("Payoff per Grade", "after the fee, vs staying raw"))
         console.print(table)
         if any(l.low_confidence for l in d.lanes):
             console.print("  [slab.dim]! = priced off very few sales — an anecdote, "
                           "not a market.[/]")
+        if any(l.liquidity for l in d.lanes):
+            console.print("  [slab.dim]Sells = how often that grade actually trades — a payoff "
+                          "at a grade that sells twice a year is a longer wait than one that "
+                          "sells weekly.[/]")
 
     console.print()
     console.print(f"  {_desk_reading_line(d)}")