cellarbrain 0.2.0__tar.gz → 0.2.2__tar.gz

{cellarbrain-0.2.0/src/cellarbrain.egg-info → cellarbrain-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cellarbrain
-Version: 0.2.0
+Version: 0.2.2
 Summary: AI sommelier for your wine cellar — ETL pipeline, DuckDB query layer, Markdown dossiers, and MCP server for wine cellar CSV exports
 Author-email: Urban Busslinger <urbanb@me.com>
 License-Expression: MIT
@@ -324,9 +324,17 @@ src/cellarbrain/
 
 ## Development
 
+> **Note:** Unit tests and smoke tests require a source checkout of the
+> repository. They are not included in the PyPI package.
+
 ```bash
-# Install with test + research dependencies
-pip install -e ".[research]"
+# Clone and set up for development
+git clone https://github.com/urban-buss/cellarbrain.git
+cd cellarbrain
+python -m venv .venv
+.venv\Scripts\activate        # Windows
+source .venv/bin/activate      # macOS / Linux
+pip install -e ".[dev,research]"
 
 # Run tests
 pytest tests/ -v

{cellarbrain-0.2.0 → cellarbrain-0.2.2}/README.md

@@ -281,9 +281,17 @@ src/cellarbrain/
 
 ## Development
 
+> **Note:** Unit tests and smoke tests require a source checkout of the
+> repository. They are not included in the PyPI package.
+
 ```bash
-# Install with test + research dependencies
-pip install -e ".[research]"
+# Clone and set up for development
+git clone https://github.com/urban-buss/cellarbrain.git
+cd cellarbrain
+python -m venv .venv
+.venv\Scripts\activate        # Windows
+source .venv/bin/activate      # macOS / Linux
+pip install -e ".[dev,research]"
 
 # Run tests
 pytest tests/ -v

{cellarbrain-0.2.0 → cellarbrain-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cellarbrain"
-version = "0.2.0"
+version = "0.2.2"
 description = "AI sommelier for your wine cellar — ETL pipeline, DuckDB query layer, Markdown dossiers, and MCP server for wine cellar CSV exports"
 requires-python = ">=3.11"
 license = "MIT"
@@ -65,6 +65,12 @@ cellarbrain = "cellarbrain.cli:main"
 [tool.setuptools.packages.find]
 where = ["src"]
 
+[tool.setuptools.package-data]
+"cellarbrain.dashboard" = [
+    "static/**/*",
+    "templates/**/*",
+]
+
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 

cellarbrain-0.2.2/src/cellarbrain/__init__.py

@@ -0,0 +1,7 @@
+"""Cellarbrain — AI sommelier for your wine cellar."""
+
+from __future__ import annotations
+
+from importlib.metadata import version as _pkg_version
+
+__version__: str = _pkg_version("cellarbrain")

{cellarbrain-0.2.0 → cellarbrain-0.2.2}/src/cellarbrain/cli.py

@@ -9,6 +9,7 @@ import re
 import sys
 import warnings
 from datetime import UTC, datetime
+from importlib.metadata import version as _pkg_version
 
 from . import companion_markdown, incremental, markdown, transform, vinocell_reader, writer
 from . import validate as val
@@ -472,6 +473,12 @@ def _subcommand_main(argv: list[str]) -> None:
         prog="cellarbrain",
         description="Cellarbrain wine cellar toolkit — ETL, query, and agent interface.",
     )
+    parser.add_argument(
+        "-V",
+        "--version",
+        action="version",
+        version=f"%(prog)s {_pkg_version('cellarbrain')}",
+    )
     parser.add_argument(
         "-c",
         "--config",
@@ -645,6 +652,7 @@ def _subcommand_main(argv: list[str]) -> None:
     # --- doctor ---
     doc_parser = sub.add_parser("doctor", help="Run diagnostic health checks on the data directory")
     doc_parser.add_argument("--json", action="store_true", help="Output results as JSON (for scripting)")
+    doc_parser.add_argument("--strict", action="store_true", help="Treat warnings as errors (exit 1)")
     doc_parser.add_argument(
         "--check",
         type=str,
@@ -800,6 +808,7 @@ def _cmd_mcp(args: argparse.Namespace, settings: Settings) -> None:
     from .mcp_server import mcp, warm_sommelier
 
     warm_sommelier()
+    mcp.settings.port = args.port
     mcp.run(transport=args.transport)
 
 
@@ -1212,9 +1221,15 @@ def _cmd_dashboard(args: argparse.Namespace, settings: Settings) -> None:
         db_path = str(pathlib.Path(settings.paths.data_dir) / "logs" / "cellarbrain-logs.duckdb")
 
     if not pathlib.Path(db_path).exists():
-        print(f"Log store not found: {db_path}", file=sys.stderr)
-        print("Run the MCP server first to generate log data.", file=sys.stderr)
-        sys.exit(1)
+        # Create an empty log store so the dashboard can start without prior MCP usage
+        pathlib.Path(db_path).parent.mkdir(parents=True, exist_ok=True)
+        import duckdb
+
+        _con = duckdb.connect(db_path)
+        from .observability import _CREATE_TABLE_SQL
+
+        _con.execute(_CREATE_TABLE_SQL)
+        _con.close()
 
     data_dir = settings.paths.data_dir
     app = create_app(
@@ -1251,7 +1266,14 @@ def _cmd_doctor(args: argparse.Namespace, settings: Settings) -> None:
         print(json.dumps(data, indent=2))
     else:
         print(report.summary())
-    sys.exit(0 if report.ok else 1)
+
+    from .doctor import Severity
+
+    if args.strict:
+        is_ok = report.worst_severity in (Severity.OK, Severity.INFO)
+    else:
+        is_ok = report.ok
+    sys.exit(0 if is_ok else 1)
 
 
 def _cmd_backup(args: argparse.Namespace, settings: Settings) -> None:

{cellarbrain-0.2.0 → cellarbrain-0.2.2}/src/cellarbrain/dashboard/app.py

@@ -471,6 +471,56 @@ async def drinking(request: Request) -> HTMLResponse:
     )
 
 
+# ---- Food pairing ---------------------------------------------------------
+
+
+async def pairing_page(request: Request) -> HTMLResponse:
+    """Food pairing interactive page — classify dish, retrieve candidates."""
+    con = request.app.state.cellar_con
+    if con is None:
+        return _TEMPLATES.TemplateResponse(
+            request,
+            "error.html",
+            context={"message": "Cellar data not available."},
+            status_code=503,
+        )
+
+    results = None
+    params: dict[str, str | None] = {}
+
+    if request.method == "POST":
+        form = await request.form()
+        params = {
+            "dish_description": form.get("dish_description", ""),
+            "category": form.get("category") or None,
+            "weight": form.get("weight") or None,
+            "protein": form.get("protein") or None,
+            "cuisine": form.get("cuisine") or None,
+            "grapes": form.get("grapes") or None,
+        }
+
+        from cellarbrain import pairing
+
+        grape_list = [g.strip() for g in params["grapes"].split(",")] if params["grapes"] else None
+        results = pairing.retrieve_candidates(
+            con,
+            dish_description=params["dish_description"],
+            category=params["category"],
+            weight=params["weight"],
+            protein=params["protein"],
+            cuisine=params["cuisine"],
+            grapes=grape_list,
+            limit=15,
+        )
+
+    template = "partials/pairing_results.html" if _wants_partial(request) else "pairing.html"
+    return _TEMPLATES.TemplateResponse(
+        request,
+        template,
+        context={"results": results, "params": params},
+    )
+
+
 # ---- SQL playground -------------------------------------------------------
 
 _QUICK_QUERIES = [
@@ -979,6 +1029,7 @@ def build_app(
             Route("/cellar/{wine_id:int}", wine_detail),
             Route("/bottles", cellar_bottles),
             Route("/drinking", drinking),
+            Route("/pairing", pairing_page, methods=["GET", "POST"]),
             Route("/sql", sql_playground, methods=["GET", "POST"]),
             Route("/stats", stats),
             Route("/tracked", tracked),

cellarbrain-0.2.2/src/cellarbrain/dashboard/static/dashboard.js

@@ -0,0 +1,101 @@
+/**
+ * dashboard.js — Chart.js render helpers for the observability dashboard.
+ * Loaded in base.html, called from inline <script> blocks in templates.
+ */
+
+function renderBarChart(canvasId, apiUrl, label) {
+    fetch(apiUrl)
+        .then(r => r.json())
+        .then(d => {
+            new Chart(document.getElementById(canvasId), {
+                type: 'bar',
+                data: {
+                    labels: d.labels,
+                    datasets: [{
+                        label: label || 'Calls',
+                        data: d.data,
+                        backgroundColor: 'rgba(99, 102, 241, 0.5)',
+                        borderColor: 'rgb(99, 102, 241)',
+                        borderWidth: 1,
+                    }]
+                },
+                options: { responsive: true, scales: { y: { beginAtZero: true } } }
+            });
+        });
+}
+
+function renderLatencyChart(canvasId, apiUrl) {
+    fetch(apiUrl)
+        .then(r => r.json())
+        .then(d => {
+            new Chart(document.getElementById(canvasId), {
+                type: 'line',
+                data: {
+                    labels: d.labels,
+                    datasets: [
+                        { label: 'P50', data: d.p50, borderColor: '#22c55e', fill: false },
+                        { label: 'P95', data: d.p95, borderColor: '#ef4444', fill: false },
+                    ]
+                },
+                options: { responsive: true, scales: { y: { beginAtZero: true } } }
+            });
+        });
+}
+
+function renderHistogram(canvasId, apiUrl) {
+    fetch(apiUrl)
+        .then(r => r.json())
+        .then(d => {
+            new Chart(document.getElementById(canvasId), {
+                type: 'bar',
+                data: {
+                    labels: d.buckets,
+                    datasets: [{
+                        label: 'Count',
+                        data: d.counts,
+                        backgroundColor: 'rgba(234, 179, 8, 0.5)',
+                    }]
+                },
+                options: { responsive: true, scales: { y: { beginAtZero: true } } }
+            });
+        });
+}
+
+function refreshConnection() {
+    fetch('/api/refresh', { method: 'POST' })
+        .then(r => r.json())
+        .then(() => window.location.reload());
+}
+
+function renderDoughnutChart(canvasId, labels, data) {
+    const colors = [
+        '#6366f1', '#ec4899', '#f59e0b', '#10b981',
+        '#3b82f6', '#8b5cf6', '#ef4444', '#14b8a6', '#94a3b8'
+    ];
+    new Chart(document.getElementById(canvasId), {
+        type: 'doughnut',
+        data: {
+            labels: labels,
+            datasets: [{
+                data: data,
+                backgroundColor: colors.slice(0, data.length),
+            }]
+        },
+        options: { responsive: true, plugins: { legend: { position: 'right' } } }
+    });
+}
+
+function renderLineChart(canvasId, datasets) {
+    new Chart(document.getElementById(canvasId), {
+        type: 'line',
+        data: { datasets: datasets },
+        options: {
+            responsive: true,
+            scales: {
+                x: { type: 'category', title: { display: true, text: 'Month' } },
+                y: { beginAtZero: false, title: { display: true, text: 'Price (CHF)' } },
+            },
+            plugins: { legend: { position: 'top' } },
+        }
+    });
+}

cellarbrain-0.2.2/src/cellarbrain/dashboard/static/workbench.js

@@ -0,0 +1,25 @@
+/**
+ * workbench.js — form enhancement and response rendering.
+ */
+
+/* Copy response text to clipboard */
+function copyResponse(elementId) {
+    var el = document.getElementById(elementId);
+    if (el) {
+        navigator.clipboard.writeText(el.textContent);
+    }
+}
+
+/* Toggle between raw and rendered view */
+function toggleView(rawId, renderedId) {
+    var raw = document.getElementById(rawId);
+    var rendered = document.getElementById(renderedId);
+    if (raw) raw.classList.toggle('hidden');
+    if (rendered) rendered.classList.toggle('hidden');
+}
+
+/* Quick fill a form field */
+function fillField(fieldName, value) {
+    var input = document.querySelector('[name="' + fieldName + '"]');
+    if (input) input.value = value;
+}

cellarbrain-0.2.2/src/cellarbrain/dashboard/templates/base.html

@@ -0,0 +1,162 @@
+<!doctype html>
+<html lang="en" data-theme="light">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>{% block title %}Cellarbrain Explorer{% endblock %}</title>
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.min.css">
+    <script src="https://cdn.jsdelivr.net/npm/chart.js@4"></script>
+    <script src="https://unpkg.com/htmx.org@2.0.4"></script>
+    <script src="https://unpkg.com/htmx-ext-sse@2.2.2/sse.js"></script>
+    <style>
+        :root {
+            --pico-font-size: 14px;
+        }
+        nav .nav-group { display: inline-block; margin-right: 1.5rem; }
+        nav .nav-group-label {
+            font-size: 0.75rem; text-transform: uppercase;
+            color: var(--pico-muted-color); display: block; margin-bottom: 0.15rem;
+        }
+        nav a { margin-right: 0.5rem; font-size: 0.85rem; }
+        nav a.active { font-weight: bold; text-decoration: underline; }
+        nav a.disabled { color: var(--pico-muted-color); pointer-events: none; opacity: 0.5; }
+        .kpi-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(160px, 1fr)); gap: 1rem; margin-bottom: 1.5rem; }
+        .kpi-card { padding: 1rem; border-radius: 8px; background: var(--pico-card-background-color); border: 1px solid var(--pico-muted-border-color); text-align: center; }
+        .kpi-card .value { font-size: 1.8rem; font-weight: bold; }
+        .kpi-card .label { font-size: 0.8rem; color: var(--pico-muted-color); }
+        .period-selector { display: inline-flex; gap: 0.25rem; }
+        .period-selector a { padding: 0.2rem 0.6rem; border-radius: 4px; font-size: 0.8rem; text-decoration: none; }
+        .period-selector a.active { background: var(--pico-primary); color: white; }
+        .chart-container { position: relative; height: 250px; margin-bottom: 1.5rem; }
+        .toolbar { display: flex; justify-content: space-between; align-items: center; margin-bottom: 1rem; flex-wrap: wrap; gap: 0.5rem; }
+        table { font-size: 0.85rem; }
+        .badge { padding: 0.15rem 0.4rem; border-radius: 4px; font-size: 0.75rem; }
+        .badge-ok { background: #dcfce7; color: #166534; }
+        .badge-warn { background: #fef9c3; color: #854d0e; }
+        .badge-error { background: #fecaca; color: #991b1b; }
+        .mono { font-family: monospace; font-size: 0.8rem; }
+        .truncate { max-width: 200px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+        .hidden { display: none; }
+        footer { margin-top: 2rem; padding-top: 1rem; border-top: 1px solid var(--pico-muted-border-color); font-size: 0.75rem; color: var(--pico-muted-color); }
+        /* Live tail event cards */
+        .event-card { padding: 0.3rem 0.5rem; border-bottom: 1px solid var(--pico-muted-border-color); font-size: 0.8rem; font-family: monospace; }
+        .event-card.error { background: #fef2f2; }
+        .event-card .ts { color: var(--pico-muted-color); }
+        .event-card .type { color: var(--pico-primary); }
+        .event-card .name { font-weight: 600; }
+        .event-card .status { margin-left: 0.3rem; }
+        .event-card .ms { color: var(--pico-muted-color); margin-left: 0.3rem; }
+        .turn-boundary { padding: 0.2rem 0.5rem; font-size: 0.7rem; color: var(--pico-muted-color); text-align: center; border-bottom: 1px solid var(--pico-muted-border-color); }
+        .live-toolbar { display: flex; gap: 0.5rem; align-items: center; margin-bottom: 0.5rem; }
+        .live-toolbar select { width: auto; padding: 0.2rem 0.4rem; font-size: 0.75rem; margin: 0; }
+        .live-toolbar button { font-size: 0.75rem; padding: 0.2rem 0.6rem; }
+        .status-dot { display: inline-block; width: 8px; height: 8px; border-radius: 50%; margin-right: 0.3rem; }
+        .status-dot.connected { background: #22c55e; }
+        .status-dot.disconnected { background: #ef4444; }
+    </style>
+</head>
+<body>
+    <main class="container-fluid">
+        <nav>
+            <div class="nav-group">
+                <span class="nav-group-label">Cellar</span>
+                <a href="/cellar" class="{% if active_nav == 'cellar' %}active{% endif %}">Wines</a>
+                <a href="/bottles" class="{% if active_nav == 'bottles' %}active{% endif %}">Bottles</a>
+                <a href="/tracked" class="{% if active_nav == 'tracked' %}active{% endif %}">Tracked</a>
+                <a href="/stats" class="{% if active_nav == 'stats' %}active{% endif %}">Stats</a>
+                <a href="/drinking" class="{% if active_nav == 'drinking' %}active{% endif %}">Drinking</a>
+                <a href="/pairing" class="{% if active_nav == 'pairing' %}active{% endif %}">Pairing</a>
+                <a href="/sql" class="{% if active_nav == 'sql' %}active{% endif %}">SQL</a>
+            </div>
+            <div class="nav-group">
+                <span class="nav-group-label">Server</span>
+                <a href="/" class="{% if active_nav == 'overview' %}active{% endif %}">Overview</a>
+                <a href="/tools" class="{% if active_nav == 'tools' %}active{% endif %}">Tool Usage</a>
+                <a href="/errors" class="{% if active_nav == 'errors' %}active{% endif %}">Errors</a>
+                <a href="/sessions" class="{% if active_nav == 'sessions' %}active{% endif %}">Sessions</a>
+                <a href="/latency" class="{% if active_nav == 'latency' %}active{% endif %}">Latency</a>
+                <a href="/live" class="{% if active_nav == 'live' %}active{% endif %}">Live</a>
+            </div>
+            <div class="nav-group">
+                <span class="nav-group-label">Workbench</span>
+                <a href="/workbench" class="{% if active_nav == 'workbench' %}active{% endif %}">Tools</a>
+                <a href="/workbench/batch" class="{% if active_nav == 'workbench_batch' %}active{% endif %}">Batch</a>
+            </div>
+        </nav>
+
+        <div class="toolbar">
+            <h4 style="margin:0">{% block page_title %}{% endblock %}</h4>
+            <div style="display:flex; align-items:center; gap:1rem;">
+                {% if period is defined %}
+                <div class="period-selector">
+                    {% for p in ["1h", "24h", "7d", "30d"] %}
+                    <a href="?period={{ p }}"
+                       class="{% if period == p %}active{% endif %}"
+                       hx-get="?period={{ p }}" hx-push-url="true" hx-target="body">{{ p }}</a>
+                    {% endfor %}
+                </div>
+                {% endif %}
+                {% if include_workbench is defined %}
+                <label style="font-size:0.7rem; margin:0; display:flex; align-items:center; gap:0.25rem; cursor:pointer;">
+                    <input type="checkbox" style="width:auto; margin:0;"
+                           {% if include_workbench %}checked{% endif %}
+                           onchange="var url=new URL(window.location); if(this.checked){url.searchParams.set('include_workbench','1')}else{url.searchParams.delete('include_workbench')}; window.location=url;">
+                    Workbench
+                </label>
+                {% endif %}
+                <button class="outline secondary" style="font-size:0.75rem; padding:0.2rem 0.5rem;" onclick="refreshConnection()">Refresh</button>
+            </div>
+        </div>
+
+        {% block content %}{% endblock %}
+
+        <footer>
+            Cellarbrain Explorer &middot; Phase 5 &middot; Live Tail
+            {% if period is defined %}
+            <span style="margin-left:1.5rem;">
+                <label style="font-size:0.7rem; margin:0; display:inline-flex; align-items:center; gap:0.25rem; cursor:pointer;">
+                    <input type="checkbox" id="auto-refresh-toggle" style="width:auto; margin:0;">
+                    Auto-refresh (30 s)
+                </label>
+            </span>
+            {% endif %}
+        </footer>
+    </main>
+    <script src="/static/dashboard.js"></script>
+    <script>
+    /* Toggle active class for inline tab / selector groups on HTMX click */
+    document.addEventListener('click', function(e) {
+        var link = e.target.closest('.period-selector a, [data-toggle-group] a, [data-toggle-group] [role="button"]');
+        if (!link) return;
+        var group = link.closest('.period-selector, [data-toggle-group]');
+        if (!group) return;
+        /* period-selector: toggle .active */
+        if (group.classList.contains('period-selector')) {
+            group.querySelectorAll('a').forEach(function(a) { a.classList.remove('active'); });
+            link.classList.add('active');
+        } else {
+            /* button-style toggles (contrast / outline secondary) */
+            group.querySelectorAll('a[role="button"], button').forEach(function(a) {
+                a.className = a.className.replace('contrast', 'outline secondary');
+            });
+            link.className = link.className.replace('outline secondary', 'contrast');
+        }
+    });
+    </script>
+    <script>
+    (function(){
+        var toggle = document.getElementById('auto-refresh-toggle');
+        if (!toggle) return;
+        var timer = null;
+        toggle.addEventListener('change', function(){
+            if (this.checked) {
+                timer = setInterval(function(){ window.location.reload(); }, 30000);
+            } else {
+                if (timer) { clearInterval(timer); timer = null; }
+            }
+        });
+    })();
+    </script>
+    {% block scripts %}{% endblock %}
+</body>
+</html>

cellarbrain-0.2.2/src/cellarbrain/dashboard/templates/bottles.html

@@ -0,0 +1,68 @@
+{% extends "base.html" %}
+
+{% set active_nav = "bottles" %}
+{% block title %}Bottle Inventory — Cellarbrain Explorer{% endblock %}
+{% block page_title %}Bottle Inventory{% endblock %}
+
+{% block content %}
+<div style="display:flex; gap:0.5rem; margin-bottom:1rem; flex-wrap:wrap; align-items:center;">
+    <div class="period-selector">
+        {% for v, label in [("stored", "Stored"), ("on_order", "On Order"), ("consumed", "Consumed"), ("all", "All")] %}
+        <a href="/bottles?view={{ v }}&cellar={{ cellar_filter }}&category={{ category }}"
+           hx-get="/bottles?view={{ v }}&cellar={{ cellar_filter }}&category={{ category }}"
+           hx-target="#bottle-tbody" hx-swap="innerHTML"
+           class="{% if view == v %}active{% endif %}">{{ label }}</a>
+        {% endfor %}
+    </div>
+    <div style="margin-left:1rem;">
+        <select name="cellar" style="font-size:0.85rem; padding:0.2rem 0.5rem;"
+                hx-get="/bottles" hx-target="#bottle-tbody" hx-swap="innerHTML"
+                hx-include="[name='view_val'],[name='category']">
+            <option value="">All cellars</option>
+            {% for c in cellar_names %}
+            <option value="{{ c }}" {% if cellar_filter == c %}selected{% endif %}>{{ c }}</option>
+            {% endfor %}
+        </select>
+        <input type="hidden" name="view_val" value="{{ view }}">
+    </div>
+</div>
+
+<figure>
+<table role="grid">
+    <thead>
+        <tr>
+            {% set base_params = "view=" ~ view ~ "&cellar=" ~ cellar_filter ~ "&category=" ~ category %}
+            {% for col_id, col_label in [("wine_name", "Wine"), ("vintage", "Vintage"), ("cellar_name", "Cellar"), ("shelf", "Shelf"), ("price", "Price"), ("status", "Status")] %}
+            <th>
+                <a href="/bottles?{{ base_params }}&sort={{ col_id }}&dir={% if sort == col_id and not desc %}desc{% else %}asc{% endif %}"
+                   hx-get="/bottles?{{ base_params }}&sort={{ col_id }}&dir={% if sort == col_id and not desc %}desc{% else %}asc{% endif %}"
+                   hx-target="#bottle-tbody" hx-swap="innerHTML">
+                    {{ col_label }}{% if sort == col_id %}{{ " ▼" if desc else " ▲" }}{% endif %}
+                </a>
+            </th>
+            {% endfor %}
+        </tr>
+    </thead>
+    <tbody id="bottle-tbody">
+        {% include "partials/bottle_rows.html" %}
+    </tbody>
+</table>
+</figure>
+
+<div style="display:flex; justify-content:space-between; align-items:center; margin-top:1rem;">
+    <span style="font-size:0.85rem; color:var(--pico-muted-color);">
+        {{ total }} bottle{{ "s" if total != 1 }}
+    </span>
+    <div style="display:flex; gap:0.5rem; align-items:center;">
+        {% if page > 1 %}
+        <a href="/bottles?page={{ page - 1 }}&{{ base_params }}&sort={{ sort }}&dir={% if desc %}desc{% else %}asc{% endif %}"
+           role="button" class="outline secondary" style="font-size:0.8rem; padding:0.2rem 0.6rem;">← Prev</a>
+        {% endif %}
+        <span style="font-size:0.85rem;">Page {{ page }} of {{ total_pages }}</span>
+        {% if page < total_pages %}
+        <a href="/bottles?page={{ page + 1 }}&{{ base_params }}&sort={{ sort }}&dir={% if desc %}desc{% else %}asc{% endif %}"
+           role="button" class="outline secondary" style="font-size:0.8rem; padding:0.2rem 0.6rem;">Next →</a>
+        {% endif %}
+    </div>
+</div>
+{% endblock %}