codex-stats 1.3.0__tar.gz → 1.4.2__tar.gz

{codex_stats-1.3.0/src/codex_stats.egg-info → codex_stats-1.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-stats
-Version: 1.3.0
+Version: 1.4.2
 Summary: Local AI usage observability CLI for Codex sessions.
 Author: Vivek
 License: MIT
@@ -108,13 +108,21 @@ python3 -m pip install codex-stats
 - `codex-stats report weekly --format markdown`
   Generate a weekly report in Markdown.
 - `codex-stats report weekly --format html`
-  Generate a standalone HTML report for sharing.
+  Generate a standalone HTML report for sharing, including inline charts.
+- `codex-stats report weekly --format svg`
+  Generate a bundle of smaller standalone SVG assets in the current working directory, including a summary card plus graph-focused assets.
 - `codex-stats report weekly --project backend-api`
   Generate a weekly report for one project.
 - `codex-stats report weekly --format markdown --output weekly-report.md`
   Write a formatted report to a file.
 - `codex-stats report weekly --format html --output weekly-report.html`
   Write a polished standalone HTML report to a file.
+- `codex-stats report weekly --format svg --output weekly-report-assets`
+  Write the SVG asset bundle into the output directory you provide.
+- `codex-stats report weekly --format html --render`
+  Generate an HTML report, write it to a temp file, and open it in the default browser.
+- `codex-stats report weekly --format svg --render`
+  Generate an SVG report, write it to a temp file, and open it in the default browser.
 - `codex-stats export codex-stats-export.json`
   Export normalized local stats to JSON.
 - `codex-stats export codex-stats-export.json --since 30d`
@@ -217,6 +225,10 @@ Then import the dashboard JSON into Grafana and point it at your Prometheus-comp
 
 The current priority list lives in [docs/roadmap.md](/Users/vivek/Desktop/Salad/codex_stats/docs/roadmap.md).
 
+## Shareable Assets
+
+Share-ready assets now live under [docs/assets/codex-stats-share-card.svg](/Users/vivek/Desktop/Salad/codex_stats/docs/assets/codex-stats-share-card.svg), and `report --format svg` can generate a full bundle of report assets directly from local usage data.
+
 ## Watch Alerts
 
 `watch` can surface live warnings and critical alerts directly in the terminal dashboard.

{codex_stats-1.3.0 → codex_stats-1.4.2}/README.md

@@ -81,13 +81,21 @@ python3 -m pip install codex-stats
 - `codex-stats report weekly --format markdown`
   Generate a weekly report in Markdown.
 - `codex-stats report weekly --format html`
-  Generate a standalone HTML report for sharing.
+  Generate a standalone HTML report for sharing, including inline charts.
+- `codex-stats report weekly --format svg`
+  Generate a bundle of smaller standalone SVG assets in the current working directory, including a summary card plus graph-focused assets.
 - `codex-stats report weekly --project backend-api`
   Generate a weekly report for one project.
 - `codex-stats report weekly --format markdown --output weekly-report.md`
   Write a formatted report to a file.
 - `codex-stats report weekly --format html --output weekly-report.html`
   Write a polished standalone HTML report to a file.
+- `codex-stats report weekly --format svg --output weekly-report-assets`
+  Write the SVG asset bundle into the output directory you provide.
+- `codex-stats report weekly --format html --render`
+  Generate an HTML report, write it to a temp file, and open it in the default browser.
+- `codex-stats report weekly --format svg --render`
+  Generate an SVG report, write it to a temp file, and open it in the default browser.
 - `codex-stats export codex-stats-export.json`
   Export normalized local stats to JSON.
 - `codex-stats export codex-stats-export.json --since 30d`
@@ -190,6 +198,10 @@ Then import the dashboard JSON into Grafana and point it at your Prometheus-comp
 
 The current priority list lives in [docs/roadmap.md](/Users/vivek/Desktop/Salad/codex_stats/docs/roadmap.md).
 
+## Shareable Assets
+
+Share-ready assets now live under [docs/assets/codex-stats-share-card.svg](/Users/vivek/Desktop/Salad/codex_stats/docs/assets/codex-stats-share-card.svg), and `report --format svg` can generate a full bundle of report assets directly from local usage data.
+
 ## Watch Alerts
 
 `watch` can surface live warnings and critical alerts directly in the terminal dashboard.

{codex_stats-1.3.0 → codex_stats-1.4.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codex-stats"
-version = "1.3.0"
+version = "1.4.2"
 description = "Local AI usage observability CLI for Codex sessions."
 readme = "README.md"
 requires-python = ">=3.11"

{codex_stats-1.3.0 → codex_stats-1.4.2}/src/codex_stats/__init__.py

@@ -1,3 +1,3 @@
 __all__ = ["__version__"]
 
-__version__ = "1.3.0"
+__version__ = "1.4.2"

{codex_stats-1.3.0 → codex_stats-1.4.2}/src/codex_stats/cli.py

@@ -3,7 +3,9 @@ from __future__ import annotations
 import argparse
 import os
 import sys
+import tempfile
 import time
+import webbrowser
 from datetime import datetime, timedelta
 from pathlib import Path
 
@@ -23,6 +25,8 @@ from .display import (
     format_report,
     format_report_html,
     format_report_markdown,
+    format_report_svg_assets,
+    format_report_svg,
     format_session,
     format_summary,
     format_top,
@@ -152,9 +156,10 @@ def build_parser() -> argparse.ArgumentParser:
 
     report_parser = subparsers.add_parser("report", help="Generate a shareable usage report.")
     report_parser.add_argument("period", choices=["weekly", "monthly"], help="Report period.")
-    report_parser.add_argument("--format", choices=["text", "markdown", "html", "json"], default="text", help="Output format.")
+    report_parser.add_argument("--format", choices=["text", "markdown", "html", "svg", "json"], default="text", help="Output format.")
     report_parser.add_argument("--project", dest="project_name", help="Generate the report for one project.")
     report_parser.add_argument("--output", help="Write the report to a file instead of stdout.")
+    report_parser.add_argument("--render", action="store_true", help="Open an HTML report in the default browser.")
 
     merge_parser = subparsers.add_parser("merge", help="Merge one or more exported stats files into one snapshot.")
     merge_parser.add_argument("output", help="Merged output JSON file.")
@@ -398,20 +403,46 @@ def main(argv: list[str] | None = None) -> int:
         return 0
 
     if args.command == "report":
+        if args.render and args.format not in {"html", "svg"}:
+            print("--render requires --format html or --format svg", file=sys.stderr)
+            return 1
         report = build_report(paths, period=args.period, project_name=args.project_name)
+        daily_points = None
+        if args.format in {"html", "svg"}:
+            report_days = 7 if args.period == "weekly" else 30
+            report_details = filter_details_by_project(details_for_last_days(paths, report_days), args.project_name)
+            daily_points = summarize_daily_from_details(report_details, days=report_days)
         if args.format == "json":
             content = as_json(report.to_dict())
         elif args.format == "html":
-            content = format_report_html(report)
+            content = format_report_html(report, daily_points=daily_points)
+        elif args.format == "svg":
+            assets = format_report_svg_assets(report, daily_points=daily_points)
+            output_dir = _write_report_svg_assets(
+                assets,
+                args.output,
+                base_name=_default_report_basename(args.period, args.project_name),
+            )
+            print(f"Wrote SVG assets to {output_dir}")
+            if args.render:
+                summary_path = output_dir / f"{_default_report_basename(args.period, args.project_name)}-summary-card.svg"
+                _open_report_in_browser(summary_path)
+                print(f"Opened report in browser: {summary_path}")
+            return 0
         elif args.format == "markdown":
             content = format_report_markdown(report)
         else:
             content = format_report(report, options)
-        if args.output:
-            output_path = Path(args.output).expanduser()
-            output_path.parent.mkdir(parents=True, exist_ok=True)
-            output_path.write_text(content + ("" if content.endswith("\n") else "\n"), encoding="utf-8")
+        if args.output or args.render:
+            output_path = _write_report_output(
+                content,
+                args.output,
+                suffix=f".{args.format}" if args.format in {"html", "svg"} else ".txt",
+            )
             print(f"Wrote report to {output_path}")
+            if args.render:
+                _open_report_in_browser(output_path)
+                print(f"Opened report in browser: {output_path}")
         else:
             print(content)
         return 0
@@ -585,10 +616,52 @@ def main(argv: list[str] | None = None) -> int:
     parser.print_help()
     return 1
 
+def summarize_details_for_range(days: int, details):
+    return summarize_imported_details(details, label=f"last {max(days, 1)} days")
 
-if __name__ == "__main__":
-    raise SystemExit(main())
 
+def _write_report_output(content: str, output: str | None, *, suffix: str, default_name: str | None = None) -> Path:
+    if output:
+        output_path = Path(output).expanduser()
+    elif default_name:
+        output_path = Path.cwd() / default_name
+    else:
+        handle = tempfile.NamedTemporaryFile(prefix="codex-stats-report-", suffix=suffix, delete=False)
+        handle.close()
+        output_path = Path(handle.name)
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+    output_path.write_text(content + ("" if content.endswith("\n") else "\n"), encoding="utf-8")
+    return output_path
 
-def summarize_details_for_range(days: int, details):
-    return summarize_imported_details(details, label=f"last {max(days, 1)} days")
+
+def _open_report_in_browser(path: Path) -> None:
+    webbrowser.open(path.resolve().as_uri())
+
+
+def _default_report_filename(period: str, project_name: str | None, fmt: str) -> str:
+    if project_name:
+        safe_project = "".join(char.lower() if char.isalnum() else "-" for char in project_name).strip("-")
+        safe_project = safe_project or "project"
+        return f"codex-stats-{period}-{safe_project}.{fmt}"
+    return f"codex-stats-{period}.{fmt}"
+
+
+def _default_report_basename(period: str, project_name: str | None) -> str:
+    if project_name:
+        safe_project = "".join(char.lower() if char.isalnum() else "-" for char in project_name).strip("-")
+        safe_project = safe_project or "project"
+        return f"codex-stats-{period}-{safe_project}"
+    return f"codex-stats-{period}"
+
+
+def _write_report_svg_assets(assets: dict[str, str], output: str | None, *, base_name: str) -> Path:
+    output_dir = Path(output).expanduser() if output else Path.cwd()
+    output_dir.mkdir(parents=True, exist_ok=True)
+    for asset_name, content in assets.items():
+        asset_path = output_dir / f"{base_name}-{asset_name}.svg"
+        asset_path.write_text(content + ("" if content.endswith("\n") else "\n"), encoding="utf-8")
+    return output_dir
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

{codex_stats-1.3.0 → codex_stats-1.4.2}/src/codex_stats/display.py

@@ -308,12 +308,13 @@ def format_report_markdown(report: ReportData) -> str:
     return "\n".join(lines)
 
 
-def format_report_html(report: ReportData) -> str:
+def format_report_html(report: ReportData, daily_points: list[DailyPoint] | None = None) -> str:
     title = f"Codex Stats {report.period.title()} Report"
     if report.project_name:
         title = f"{title}: {report.project_name}"
     delta_pct = "n/a" if report.comparison.total_tokens_delta_pct is None else f"{report.comparison.total_tokens_delta_pct:+.1f}%"
     delta_color = "var(--warn)" if delta_pct.startswith("+") else "var(--good)"
+    daily_points = daily_points or []
     projects_html = ""
     if report.project_name is None:
         if report.projects:
@@ -371,6 +372,30 @@ def format_report_html(report: ReportData) -> str:
 
     anomalies_html = "".join(f"<li>{escape(item)}</li>" for item in report.insights.anomalies) or "<li>none</li>"
     recommendations_html = "".join(f"<li>{escape(item)}</li>" for item in report.insights.recommendations) or "<li>none</li>"
+    token_trend_svg = _svg_line_chart(
+        [(point.day[5:], float(point.total_tokens)) for point in daily_points],
+        stroke="#0f766e",
+        fill="rgba(15, 118, 110, 0.12)",
+        value_formatter=lambda value: f"{int(value):,}",
+    )
+    cost_trend_svg = _svg_line_chart(
+        [(point.day[5:], float(point.estimated_cost_usd)) for point in daily_points],
+        stroke="#b45309",
+        fill="rgba(180, 83, 9, 0.14)",
+        value_formatter=lambda value: f"${value:.2f}",
+    )
+    project_share_svg = _svg_bar_chart(
+        [(entry.name, float(entry.total_tokens)) for entry in report.projects[:5]],
+        bar_color="#0f766e",
+        value_formatter=lambda value: f"{int(value):,}",
+        empty_label="No project breakdown for this scoped report.",
+    )
+    session_share_svg = _svg_bar_chart(
+        [(f"{entry.project_name} / {entry.model or 'unknown'}", float(entry.total_tokens)) for entry in report.top_sessions[:5]],
+        bar_color="#b45309",
+        value_formatter=lambda value: f"{int(value):,}",
+        empty_label="No top session data available.",
+    )
 
     return f"""<!DOCTYPE html>
 <html lang="en">
@@ -572,6 +597,31 @@ def format_report_html(report: ReportData) -> str:
     .table-wrap {{
       overflow-x: auto;
     }}
+    .chart-grid {{
+      display: grid;
+      grid-template-columns: repeat(2, minmax(0, 1fr));
+      gap: 18px;
+    }}
+    .chart-card {{
+      background: var(--panel-strong);
+      border: 1px solid var(--line);
+      border-radius: 18px;
+      padding: 16px;
+    }}
+    .chart-card h3 {{
+      margin: 0 0 10px;
+      font-size: 1rem;
+    }}
+    .chart-svg {{
+      width: 100%;
+      height: auto;
+      display: block;
+    }}
+    .chart-empty {{
+      color: var(--muted);
+      font-size: 0.95rem;
+      padding: 12px 0 6px;
+    }}
     .list-grid {{
       display: grid;
       grid-template-columns: repeat(2, minmax(0, 1fr));
@@ -592,7 +642,7 @@ def format_report_html(report: ReportData) -> str:
       text-align: right;
     }}
     @media (max-width: 900px) {{
-      .hero-grid, .split, .list-grid, .metrics {{ grid-template-columns: 1fr; }}
+      .hero-grid, .split, .list-grid, .metrics, .chart-grid {{ grid-template-columns: 1fr; }}
     }}
   </style>
 </head>
@@ -649,6 +699,30 @@ def format_report_html(report: ReportData) -> str:
         </div>
       </section>
 
+      <section class="panel">
+        <div class="section-header">
+          <h2>Charts</h2>
+        </div>
+        <div class="chart-grid">
+          <div class="chart-card">
+            <h3>Daily Token Trend</h3>
+            {token_trend_svg}
+          </div>
+          <div class="chart-card">
+            <h3>Daily Cost Trend</h3>
+            {cost_trend_svg}
+          </div>
+          <div class="chart-card">
+            <h3>Project Share</h3>
+            {project_share_svg}
+          </div>
+          <div class="chart-card">
+            <h3>Top Sessions by Tokens</h3>
+            {session_share_svg}
+          </div>
+        </div>
+      </section>
+
       {projects_html}
 
       <section class="panel">
@@ -714,6 +788,234 @@ def format_report_html(report: ReportData) -> str:
 """
 
 
+def format_report_svg_assets(report: ReportData, daily_points: list[DailyPoint] | None = None) -> dict[str, str]:
+    title = f"Codex Stats {report.period.title()} Report"
+    if report.project_name:
+        title = f"{title}: {report.project_name}"
+    daily_points = daily_points or []
+    assets = {
+        "summary-card": _format_summary_card_svg(report, title),
+        "daily-tokens": _wrap_chart_svg(
+            title="Daily Token Trend",
+            subtitle=title,
+            chart_svg=_svg_line_chart(
+                [(point.day[5:], float(point.total_tokens)) for point in daily_points],
+                stroke="#0f766e",
+                fill="rgba(15, 118, 110, 0.14)",
+                value_formatter=lambda value: f"{int(value):,}",
+            ),
+        ),
+        "daily-cost": _wrap_chart_svg(
+            title="Daily Cost Trend",
+            subtitle=title,
+            chart_svg=_svg_line_chart(
+                [(point.day[5:], float(point.estimated_cost_usd)) for point in daily_points],
+                stroke="#b45309",
+                fill="rgba(180, 83, 9, 0.14)",
+                value_formatter=lambda value: f"${value:.2f}",
+            ),
+        ),
+        "project-share": _wrap_chart_svg(
+            title="Project Share",
+            subtitle=title,
+            chart_svg=_svg_bar_chart(
+                [(entry.name, float(entry.total_tokens)) for entry in report.projects[:5]],
+                bar_color="#0f766e",
+                value_formatter=lambda value: f"{int(value):,}",
+                empty_label="No project breakdown for this scoped report.",
+            ),
+        ),
+        "top-sessions": _wrap_chart_svg(
+            title="Top Sessions",
+            subtitle=title,
+            chart_svg=_svg_bar_chart(
+                [(f"{entry.project_name} / {entry.model or 'unknown'}", float(entry.total_tokens)) for entry in report.top_sessions[:5]],
+                bar_color="#b45309",
+                value_formatter=lambda value: f"{int(value):,}",
+                empty_label="No top session data available.",
+            ),
+        ),
+    }
+    return assets
+
+
+def format_report_svg(report: ReportData, daily_points: list[DailyPoint] | None = None) -> str:
+    return format_report_svg_assets(report, daily_points)["summary-card"]
+
+
+def _svg_line_chart(
+    points: list[tuple[str, float]],
+    *,
+    stroke: str,
+    fill: str,
+    value_formatter,
+) -> str:
+    if not points:
+        return '<div class="chart-empty">No data available.</div>'
+    width = 760
+    height = 240
+    padding_left = 48
+    padding_right = 20
+    padding_top = 20
+    padding_bottom = 38
+    values = [value for _, value in points]
+    max_value = max(values) if max(values) > 0 else 1.0
+    inner_width = width - padding_left - padding_right
+    inner_height = height - padding_top - padding_bottom
+
+    def point_x(index: int) -> float:
+        if len(points) == 1:
+            return padding_left + inner_width / 2
+        return padding_left + (index / (len(points) - 1)) * inner_width
+
+    def point_y(value: float) -> float:
+        return padding_top + inner_height - (value / max_value) * inner_height
+
+    line_points = " ".join(f"{point_x(index):.1f},{point_y(value):.1f}" for index, (_, value) in enumerate(points))
+    area_points = f"{padding_left:.1f},{padding_top + inner_height:.1f} {line_points} {padding_left + inner_width:.1f},{padding_top + inner_height:.1f}"
+    labels = "".join(
+        f'<text x="{point_x(index):.1f}" y="{height - 12}" text-anchor="middle" font-size="11" fill="#6d645d">{escape(label)}</text>'
+        for index, (label, _) in enumerate(points)
+    )
+    dots = "".join(
+        f'<circle cx="{point_x(index):.1f}" cy="{point_y(value):.1f}" r="4" fill="{stroke}"><title>{escape(label)}: {escape(value_formatter(value))}</title></circle>'
+        for index, (label, value) in enumerate(points)
+    )
+    grid = "".join(
+        f'<line x1="{padding_left}" y1="{padding_top + step * (inner_height / 3):.1f}" x2="{width - padding_right}" y2="{padding_top + step * (inner_height / 3):.1f}" stroke="rgba(72,53,36,0.12)" stroke-dasharray="4 6" />'
+        for step in range(4)
+    )
+    y_labels = "".join(
+        f'<text x="{padding_left - 8}" y="{padding_top + inner_height - step * (inner_height / 3) + 4:.1f}" text-anchor="end" font-size="11" fill="#6d645d">{escape(value_formatter((max_value / 3) * step))}</text>'
+        for step in range(4)
+    )
+    return (
+        f'<svg xmlns="http://www.w3.org/2000/svg" class="chart-svg" viewBox="0 0 {width} {height}" role="img" aria-label="Trend chart">'
+        f'{grid}'
+        f'<polygon points="{area_points}" fill="{fill}" />'
+        f'<polyline points="{line_points}" fill="none" stroke="{stroke}" stroke-width="4" stroke-linecap="round" stroke-linejoin="round" />'
+        f'{dots}{labels}{y_labels}</svg>'
+    )
+
+
+def _svg_bar_chart(
+    bars: list[tuple[str, float]],
+    *,
+    bar_color: str,
+    value_formatter,
+    empty_label: str,
+) -> str:
+    if not bars:
+        return f'<div class="chart-empty">{escape(empty_label)}</div>'
+    width = 760
+    row_height = 34
+    padding = 18
+    label_width = 170
+    bar_max_width = width - (padding * 2) - label_width - 90
+    height = padding * 2 + row_height * len(bars)
+    max_value = max(value for _, value in bars) if max(value for _, value in bars) > 0 else 1.0
+    rows = []
+    for index, (label, value) in enumerate(bars):
+        y = padding + index * row_height
+        bar_width = (value / max_value) * bar_max_width
+        rows.append(
+            f'<text x="{padding}" y="{y + 20}" font-size="12" fill="#1f1a17">{escape(label)}</text>'
+            f'<rect x="{padding + label_width}" y="{y + 6}" width="{bar_max_width:.1f}" height="16" rx="8" fill="rgba(72,53,36,0.08)" />'
+            f'<rect x="{padding + label_width}" y="{y + 6}" width="{bar_width:.1f}" height="16" rx="8" fill="{bar_color}" />'
+            f'<text x="{padding + label_width + bar_max_width + 10}" y="{y + 19}" font-size="12" fill="#6d645d">{escape(value_formatter(value))}</text>'
+        )
+    return f'<svg xmlns="http://www.w3.org/2000/svg" class="chart-svg" viewBox="0 0 {width} {height}" role="img" aria-label="Bar chart">{"".join(rows)}</svg>'
+
+
+def _format_summary_card_svg(report: ReportData, title: str) -> str:
+    delta_text = "n/a" if report.comparison.total_tokens_delta_pct is None else f"{report.comparison.total_tokens_delta_pct:+.1f}%"
+    anomalies = report.insights.anomalies[:2] or ["No active anomalies"]
+    recommendations = report.insights.recommendations[:2] or ["Usage looks healthy."]
+    first_action = recommendations[0]
+    second_action = recommendations[1] if len(recommendations) > 1 else recommendations[0]
+    first_anomaly = anomalies[0]
+    second_anomaly = anomalies[1] if len(anomalies) > 1 else anomalies[0]
+    return f"""<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="630" viewBox="0 0 1200 630" role="img" aria-label="{escape(title)}">
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#fbf5ec"/>
+      <stop offset="100%" stop-color="#efe2cf"/>
+    </linearGradient>
+    <linearGradient id="teal" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#115e59"/>
+      <stop offset="100%" stop-color="#0f766e"/>
+    </linearGradient>
+    <linearGradient id="amber" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#b45309"/>
+      <stop offset="100%" stop-color="#d97706"/>
+    </linearGradient>
+  </defs>
+  <rect width="1200" height="630" fill="url(#bg)"/>
+  <rect x="34" y="28" width="1132" height="574" rx="32" fill="#fffaf2" stroke="rgba(66,48,31,0.10)"/>
+
+  <circle cx="1056" cy="126" r="118" fill="rgba(15,118,110,0.10)"/>
+  <circle cx="1116" cy="206" r="72" fill="rgba(217,119,6,0.10)"/>
+  <circle cx="1012" cy="214" r="18" fill="#0f766e"/>
+  <circle cx="1066" cy="164" r="18" fill="#d97706"/>
+  <circle cx="1120" cy="114" r="18" fill="#0f766e"/>
+
+  <text x="74" y="86" font-size="18" letter-spacing="3" fill="#0f766e">CODEX STATS</text>
+  <text x="74" y="150" font-size="60" font-weight="700" fill="#1f1a17">{escape(title)}</text>
+  <text x="74" y="194" font-size="24" fill="#6d645d">Compact share card for release notes, README embeds, and social posts.</text>
+
+  <rect x="74" y="226" width="336" height="52" rx="26" fill="rgba(15,118,110,0.08)"/>
+  <text x="102" y="258" font-size="20" fill="#134e4a">Top model {escape(report.summary.top_model or "unknown")}</text>
+  <rect x="426" y="226" width="190" height="52" rx="26" fill="rgba(180,83,9,0.10)"/>
+  <text x="454" y="258" font-size="20" fill="#92400e">Trend {escape(delta_text)}</text>
+  <rect x="632" y="226" width="214" height="52" rx="26" fill="rgba(66,48,31,0.06)"/>
+  <text x="660" y="258" font-size="20" fill="#4b4036">Cache {escape(_fmt_percent(report.summary.cache_ratio))}</text>
+
+  <rect x="74" y="314" width="240" height="120" rx="24" fill="url(#teal)"/>
+  <text x="98" y="350" font-size="16" letter-spacing="2" fill="#d7faf5">TOKENS</text>
+  <text x="98" y="397" font-size="40" font-weight="700" fill="#ffffff">{report.summary.total_tokens:,}</text>
+  <text x="98" y="423" font-size="18" fill="#d7faf5">{report.summary.sessions} sessions</text>
+
+  <rect x="334" y="314" width="220" height="120" rx="24" fill="#fffaf2" stroke="rgba(66,48,31,0.10)"/>
+  <text x="358" y="350" font-size="16" letter-spacing="2" fill="#6d645d">EST. COST</text>
+  <text x="358" y="397" font-size="40" font-weight="700" fill="#1f1a17">${report.summary.estimated_cost_usd:.2f}</text>
+  <text x="358" y="423" font-size="18" fill="#6d645d">Projected ${report.costs.projected_monthly_cost_usd:.2f}</text>
+
+  <rect x="574" y="314" width="220" height="120" rx="24" fill="#fffaf2" stroke="rgba(66,48,31,0.10)"/>
+  <text x="598" y="350" font-size="16" letter-spacing="2" fill="#6d645d">REQUESTS</text>
+  <text x="598" y="397" font-size="40" font-weight="700" fill="#1f1a17">{report.summary.requests}</text>
+  <text x="598" y="423" font-size="18" fill="#6d645d">Largest {report.summary.largest_session_tokens:,}</text>
+
+  <rect x="814" y="314" width="312" height="120" rx="24" fill="url(#amber)"/>
+  <text x="838" y="350" font-size="16" letter-spacing="2" fill="#ffedd5">AVG / REQUEST</text>
+  <text x="838" y="397" font-size="40" font-weight="700" fill="#ffffff">{report.summary.average_tokens_per_request:,.0f}</text>
+  <text x="838" y="423" font-size="18" fill="#ffedd5">{escape(report.insights.suggestion[:34])}</text>
+
+  <rect x="74" y="466" width="492" height="94" rx="24" fill="#fffaf2" stroke="rgba(66,48,31,0.10)"/>
+  <text x="98" y="500" font-size="18" letter-spacing="2" fill="#8a4b0f">ANOMALIES</text>
+  <text x="98" y="530" font-size="20" fill="#8a4b0f">• {escape(first_anomaly)}</text>
+  <text x="98" y="556" font-size="20" fill="#8a4b0f">• {escape(second_anomaly)}</text>
+
+  <rect x="592" y="466" width="534" height="94" rx="24" fill="#fffaf2" stroke="rgba(66,48,31,0.10)"/>
+  <text x="616" y="500" font-size="18" letter-spacing="2" fill="#4b4036">DO NEXT</text>
+  <text x="616" y="530" font-size="20" fill="#4b4036">• {escape(first_action)}</text>
+  <text x="616" y="556" font-size="20" fill="#4b4036">• {escape(second_action)}</text>
+
+  <text x="1128" y="590" text-anchor="end" font-size="18" fill="#6d645d">Generated by codex-stats</text>
+</svg>"""
+
+
+def _wrap_chart_svg(title: str, subtitle: str, chart_svg: str) -> str:
+    chart_body = chart_svg.strip()
+    return f"""<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="720" viewBox="0 0 1200 720" role="img" aria-label="{escape(title)}">
+  <rect width="1200" height="720" fill="#f6efe4"/>
+  <rect x="40" y="36" width="1120" height="648" rx="30" fill="#fffaf2" stroke="rgba(66,48,31,0.10)"/>
+  <text x="72" y="94" font-size="18" letter-spacing="3" fill="#0f766e">CODEX STATS</text>
+  <text x="72" y="148" font-size="42" font-weight="700" fill="#1f1a17">{escape(title)}</text>
+  <text x="72" y="184" font-size="22" fill="#6d645d">{escape(subtitle)}</text>
+  <g transform="translate(72 220)">{chart_body}</g>
+</svg>"""
+
+
 def format_watch_dashboard(
     summary: TimeSummary,
     compare: CompareReport,

{codex_stats-1.3.0 → codex_stats-1.4.2/src/codex_stats.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-stats
-Version: 1.3.0
+Version: 1.4.2
 Summary: Local AI usage observability CLI for Codex sessions.
 Author: Vivek
 License: MIT
@@ -108,13 +108,21 @@ python3 -m pip install codex-stats
 - `codex-stats report weekly --format markdown`
   Generate a weekly report in Markdown.
 - `codex-stats report weekly --format html`
-  Generate a standalone HTML report for sharing.
+  Generate a standalone HTML report for sharing, including inline charts.
+- `codex-stats report weekly --format svg`
+  Generate a bundle of smaller standalone SVG assets in the current working directory, including a summary card plus graph-focused assets.
 - `codex-stats report weekly --project backend-api`
   Generate a weekly report for one project.
 - `codex-stats report weekly --format markdown --output weekly-report.md`
   Write a formatted report to a file.
 - `codex-stats report weekly --format html --output weekly-report.html`
   Write a polished standalone HTML report to a file.
+- `codex-stats report weekly --format svg --output weekly-report-assets`
+  Write the SVG asset bundle into the output directory you provide.
+- `codex-stats report weekly --format html --render`
+  Generate an HTML report, write it to a temp file, and open it in the default browser.
+- `codex-stats report weekly --format svg --render`
+  Generate an SVG report, write it to a temp file, and open it in the default browser.
 - `codex-stats export codex-stats-export.json`
   Export normalized local stats to JSON.
 - `codex-stats export codex-stats-export.json --since 30d`
@@ -217,6 +225,10 @@ Then import the dashboard JSON into Grafana and point it at your Prometheus-comp
 
 The current priority list lives in [docs/roadmap.md](/Users/vivek/Desktop/Salad/codex_stats/docs/roadmap.md).
 
+## Shareable Assets
+
+Share-ready assets now live under [docs/assets/codex-stats-share-card.svg](/Users/vivek/Desktop/Salad/codex_stats/docs/assets/codex-stats-share-card.svg), and `report --format svg` can generate a full bundle of report assets directly from local usage data.
+
 ## Watch Alerts
 
 `watch` can surface live warnings and critical alerts directly in the terminal dashboard.

{codex_stats-1.3.0 → codex_stats-1.4.2}/tests/test_cli.py

@@ -1,12 +1,21 @@
 from __future__ import annotations
 
 import sys
+import tempfile
 import unittest
 from pathlib import Path
+from unittest import mock
 
 sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "src"))
 
-from codex_stats.cli import build_parser
+from codex_stats.cli import (
+    _default_report_basename,
+    _default_report_filename,
+    _open_report_in_browser,
+    _write_report_output,
+    _write_report_svg_assets,
+    build_parser,
+)
 
 
 class CliTestCase(unittest.TestCase):
@@ -155,15 +164,16 @@ class CliTestCase(unittest.TestCase):
         parser = build_parser()
         init_args = parser.parse_args(["init", "--force"])
         compare_args = parser.parse_args(["compare", "today", "yesterday"])
-        report_args = parser.parse_args(["report", "weekly", "--format", "html", "--project", "project", "--output", "weekly.html"])
+        report_args = parser.parse_args(["report", "weekly", "--format", "svg", "--project", "project", "--output", "weekly.svg", "--render"])
         self.assertEqual(init_args.command, "init")
         self.assertTrue(init_args.force)
         self.assertEqual(compare_args.current, "today")
         self.assertEqual(compare_args.previous, "yesterday")
         self.assertEqual(report_args.period, "weekly")
-        self.assertEqual(report_args.format, "html")
+        self.assertEqual(report_args.format, "svg")
         self.assertEqual(report_args.project_name, "project")
-        self.assertEqual(report_args.output, "weekly.html")
+        self.assertEqual(report_args.output, "weekly.svg")
+        self.assertTrue(report_args.render)
 
     def test_project_drilldown_parser(self) -> None:
         parser = build_parser()
@@ -188,6 +198,30 @@ class CliTestCase(unittest.TestCase):
         self.assertEqual(args.config_command, "show")
         self.assertTrue(args.json_output)
 
+    def test_write_report_output_and_browser_open(self) -> None:
+        with tempfile.TemporaryDirectory() as tmpdir:
+            output_path = _write_report_output("<html></html>", str(Path(tmpdir) / "report.html"), suffix=".html")
+            self.assertTrue(output_path.exists())
+            self.assertIn("report.html", str(output_path))
+        with tempfile.TemporaryDirectory() as tmpdir:
+            svg_dir = _write_report_svg_assets(
+                {"summary-card": "<svg></svg>", "daily-tokens": "<svg></svg>"},
+                tmpdir,
+                base_name="codex-stats-weekly",
+            )
+            self.assertEqual(svg_dir, Path(tmpdir))
+            svg_output = Path(tmpdir) / "codex-stats-weekly-summary-card.svg"
+            self.assertTrue(svg_output.exists())
+        with mock.patch("codex_stats.cli.webbrowser.open") as open_mock:
+            _open_report_in_browser(svg_output)
+        open_mock.assert_called_once()
+
+    def test_default_report_filename(self) -> None:
+        self.assertEqual(_default_report_filename("weekly", None, "svg"), "codex-stats-weekly.svg")
+        self.assertEqual(_default_report_filename("monthly", "Backend API", "svg"), "codex-stats-monthly-backend-api.svg")
+        self.assertEqual(_default_report_basename("weekly", None), "codex-stats-weekly")
+        self.assertEqual(_default_report_basename("monthly", "Backend API"), "codex-stats-monthly-backend-api")
+
 
 if __name__ == "__main__":
     unittest.main()

{codex_stats-1.3.0 → codex_stats-1.4.2}/tests/test_metrics.py

@@ -11,7 +11,7 @@ from pathlib import Path
 sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "src"))
 
 from codex_stats.config import Paths
-from codex_stats.display import format_report_html, format_watch_dashboard
+from codex_stats.display import format_report_html, format_report_svg, format_report_svg_assets, format_watch_dashboard
 from codex_stats.ingest import get_session, get_session_details
 from codex_stats.metrics import (
     apply_watch_state,
@@ -445,12 +445,28 @@ class MetricsTestCase(unittest.TestCase):
     def test_report_html_output(self) -> None:
         now = datetime.fromisoformat("2026-04-03T18:30:00+05:30")
         report = build_report(self.paths, "weekly", now=now)
-        html = format_report_html(report)
+        daily_points = summarize_daily(self.paths, days=7, now=now)
+        html = format_report_html(report, daily_points=daily_points)
         self.assertIn("<!DOCTYPE html>", html)
         self.assertIn("Codex Stats Weekly Report", html)
         self.assertIn("Top Sessions", html)
         self.assertIn("Top Projects", html)
         self.assertIn("Generated by codex-stats", html)
+        self.assertIn("<svg", html)
+        self.assertIn("Daily Token Trend", html)
+
+    def test_report_svg_output(self) -> None:
+        now = datetime.fromisoformat("2026-04-03T18:30:00+05:30")
+        report = build_report(self.paths, "weekly", now=now)
+        daily_points = summarize_daily(self.paths, days=7, now=now)
+        svg = format_report_svg(report, daily_points=daily_points)
+        assets = format_report_svg_assets(report, daily_points=daily_points)
+        self.assertIn("<svg", svg)
+        self.assertIn("Compact share card for release notes, README embeds, and social posts.", svg)
+        self.assertIn("ANOMALIES", svg)
+        self.assertIn("Generated by codex-stats", svg)
+        self.assertEqual(set(assets), {"summary-card", "daily-tokens", "daily-cost", "project-share", "top-sessions"})
+        self.assertIn("Daily Token Trend", assets["daily-tokens"])
 
 
 if __name__ == "__main__":