syscu-kiro-report-usage 0.1.0__tar.gz

syscu_kiro_report_usage-0.1.0/LICENSE

@@ -0,0 +1,25 @@
+MIT License
+
+Copyright (c) 2026 kiro-usage-report contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+Note: the logo files in src/kiro_report/assets/ (logo-light.svg, logo-dark.svg) are
+SysCu brand assets and are NOT covered by this license. The bundled Figtree font is
+distributed under the SIL Open Font License 1.1 (see src/kiro_report/assets/NOTICE.md).

syscu_kiro_report_usage-0.1.0/PKG-INFO

@@ -0,0 +1,129 @@
+Metadata-Version: 2.4
+Name: syscu-kiro-report-usage
+Version: 0.1.0
+Summary: Self-contained HTML report of Kiro usage and cost per IAM Identity Center user (AWS CUR + Kiro user activity report).
+License: MIT
+Project-URL: Homepage, https://github.com/syscu-es/syscu-kiro-report-usage
+Project-URL: Issues, https://github.com/syscu-es/syscu-kiro-report-usage/issues
+Keywords: kiro,aws,finops,cost,usage,report,iam-identity-center
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: boto3>=1.34
+Requires-Dist: pyarrow>=14
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-cov>=5; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Dynamic: license-file
+
+# kiro-usage-report
+
+Generate a **single, self-contained HTML report** of [Kiro](https://kiro.dev) usage and cost **per IAM Identity Center user** — one command, no infrastructure to deploy.
+
+![Report preview](docs/screenshot.png)
+
+It answers the questions Kiro administrators keep asking:
+
+- Who is using Kiro, on which client (IDE / CLI / Web), and with which models?
+- Credits used per day / week / month, by client type and by plan — the same views as the Kiro console dashboard, plus per-person detail.
+- What do the subscriptions cost, and how much of it is covered by AWS credits?
+- Who is on the wrong plan? Right-sizing suggestions include overage cost ($0.04/credit).
+- Which licences are idle?
+
+The output is a static `.html` file (light/dark theme, English/Spanish, date-range and daily/weekly/monthly filters, tooltips, print-friendly). Share it as an attachment; nothing is uploaded anywhere.
+
+## Quick start
+
+```bash
+pip install syscu-kiro-report-usage            # from PyPI
+pip install git+https://github.com/syscu-es/syscu-kiro-report-usage.git   # latest from GitHub
+# or from a clone:  pip install .     (development: pip install -e ".[dev]")
+
+kiro-report --demo --open        # preview with synthetic data, no AWS needed
+kiro-report                      # interactive: pick or sign in to ANY AWS account, then the period
+```
+
+Unattended:
+
+```bash
+kiro-report --profile my-sso-profile --sso-login --last 6 --out kiro.html
+kiro-report --profile prod --month 2026-10 --lang en --anonymize
+```
+
+### Works against any account, interactively
+
+Run `kiro-report` on a terminal and it asks, step by step:
+
+1. **Account** — choose one of your local profiles (`~/.aws/config` / `~/.aws/credentials`), the default credential chain, or **“Sign in with AWS IAM Identity Center”**.
+2. **IAM Identity Center sign-in (no profile needed)** — enter your start URL (`https://<name>.awsapps.com/start`) and region, approve in the browser (device authorization, the same flow as `aws sso login`), then pick any **account** and **role** you can reach (type text to filter long lists). Tokens and temporary credentials stay in memory; nothing is written to disk.
+3. **Period** — last full month, current month, last 3/6/12 months, or a custom `YYYY-MM[:YYYY-MM]` range.
+
+For an existing SSO *profile* with an expired session it offers to run `aws sso login` for you (`--sso-login` does it without asking). Everything is also scriptable: `--sso-start-url … --sso-account <id|name> --sso-role <name>`; `-y/--yes` never prompts. Set `KIRO_REPORT_SSO_START_URL` to pre-fill the start URL.
+
+## Where the data comes from
+
+| Source | Gives you | How to enable |
+|---|---|---|
+| **Kiro user activity report** (daily CSVs in S3) | client type (IDE/CLI/Web), plan, credits, **overage**, messages, models, user e-mail, new users | Kiro console → *Settings* → *User activity report* → CSV → S3 bucket. [Docs](https://kiro.dev/docs/enterprise/monitor-and-track/user-activity/) |
+| **AWS Cost and Usage Report** (Data Exports, parquet) | real subscription lines, AWS credits applied, credits per Identity Center user (`line_item_resource_id`) | Billing → Data Exports → *Standard data export (CUR 2.0)* with resource IDs, parquet |
+| **IAM Identity Center** | user names when the activity report has no e-mail | automatic |
+
+Either source can be missing: with only the activity report, costs are *estimated at list price*; with only the CUR you get per-person credits and costs but no client/plan/model breakdown (the report tells you how to enable the rest). Sources are auto-discovered; override with `--cur-export`, `--cur-bucket/--cur-prefix`, `--activity-bucket/--activity-prefix`.
+
+Required AWS permissions are read-only — see [docs/PERMISSIONS.md](docs/PERMISSIONS.md).
+
+## Options
+
+| Flag | Purpose |
+|---|---|
+| `--profile`, `--region`, `--sso-login` | pick a local profile; refresh an expired SSO session |
+| `--sso-start-url`, `--sso-region`, `--sso-account`, `--sso-role` | sign in to any account through IAM Identity Center, no profile needed |
+| `--month`, `--since`/`--until`, `--last N` | period (default: last 3 months, or asked) |
+| `--no-cur`, `--no-activity` | skip a source |
+| `--lang en\|es` | report language (also switchable inside the report) |
+| `--anonymize` | replace users with `user-NN` before sharing |
+| `--brand`, `--logo`, `--no-logo`, `--no-embed-font` | white-label the report |
+| `--json FILE` | also dump the aggregated data (feed your own dashboards) |
+| `--demo` | synthetic data, no AWS |
+
+## How it works
+
+```
+CUR (parquet) ─┐                                   ┌─> report.html (inline CSS/JS/SVG, offline)
+               ├─> model.build_report (JSON) ──────┤
+Kiro CSVs ─────┘     merge by user id,             └─> --json
+IAM Identity Center   tier right-sizing
+```
+
+`src/kiro_report/`: `cli` (prompts) · `aws` (profiles/SSO) · `cur` · `activity` · `identity` · `model` (merge + recommendations) · `tiers` (plan catalogue) · `render` + `templates/report.html`.
+
+## Related AWS projects
+
+This tool is a lightweight, local alternative to heavier setups; use them if you need always-on dashboards:
+
+- [Kiro User Activity Dashboard](https://docs.aws.amazon.com/guidance/latest/cloud-intelligence-dashboards/kiro-user-activity-dashboard.html) (Cloud Intelligence Dashboards, QuickSight)
+- [`aws-samples/sample-kiro-cost-optimizer`](https://github.com/aws-samples/sample-kiro-cost-optimizer) (serverless, e-mail recommendations)
+- [`aws-samples/sample-kiro-user-analytics-dashboard`](https://github.com/aws-samples/sample-kiro-user-analytics-dashboard)
+
+## Privacy
+
+Reports contain user e-mails and usage. Generated `kiro-report-*.html/json` are git-ignored; use `--anonymize` before sharing. Nothing leaves your machine except the AWS API calls you authorise.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest --cov=kiro_report
+ruff check .
+```
+
+Plan prices/allowances live in `src/kiro_report/tiers.py` (Kiro pricing is subject to change).
+
+## Releasing
+
+Releases are published to PyPI by GitHub Actions with [Trusted Publishing](https://docs.pypi.org/trusted-publishers/) (OIDC, no stored tokens): `.github/workflows/release.yml`. To release, bump `version` in `pyproject.toml`, merge, then push a tag `vX.Y.Z` (the workflow refuses a tag that does not match the version). Run the workflow manually with target `testpypi` to rehearse.
+
+## License
+
+MIT for the code. The SysCu logo in `src/kiro_report/assets/` is a brand asset and is **not** covered by the MIT license (replace it with `--logo`, or drop it with `--no-logo`); the bundled Figtree font is SIL OFL 1.1. See `LICENSE` and `src/kiro_report/assets/NOTICE.md`.

syscu_kiro_report_usage-0.1.0/README.md

@@ -0,0 +1,110 @@
+# kiro-usage-report
+
+Generate a **single, self-contained HTML report** of [Kiro](https://kiro.dev) usage and cost **per IAM Identity Center user** — one command, no infrastructure to deploy.
+
+![Report preview](docs/screenshot.png)
+
+It answers the questions Kiro administrators keep asking:
+
+- Who is using Kiro, on which client (IDE / CLI / Web), and with which models?
+- Credits used per day / week / month, by client type and by plan — the same views as the Kiro console dashboard, plus per-person detail.
+- What do the subscriptions cost, and how much of it is covered by AWS credits?
+- Who is on the wrong plan? Right-sizing suggestions include overage cost ($0.04/credit).
+- Which licences are idle?
+
+The output is a static `.html` file (light/dark theme, English/Spanish, date-range and daily/weekly/monthly filters, tooltips, print-friendly). Share it as an attachment; nothing is uploaded anywhere.
+
+## Quick start
+
+```bash
+pip install syscu-kiro-report-usage            # from PyPI
+pip install git+https://github.com/syscu-es/syscu-kiro-report-usage.git   # latest from GitHub
+# or from a clone:  pip install .     (development: pip install -e ".[dev]")
+
+kiro-report --demo --open        # preview with synthetic data, no AWS needed
+kiro-report                      # interactive: pick or sign in to ANY AWS account, then the period
+```
+
+Unattended:
+
+```bash
+kiro-report --profile my-sso-profile --sso-login --last 6 --out kiro.html
+kiro-report --profile prod --month 2026-10 --lang en --anonymize
+```
+
+### Works against any account, interactively
+
+Run `kiro-report` on a terminal and it asks, step by step:
+
+1. **Account** — choose one of your local profiles (`~/.aws/config` / `~/.aws/credentials`), the default credential chain, or **“Sign in with AWS IAM Identity Center”**.
+2. **IAM Identity Center sign-in (no profile needed)** — enter your start URL (`https://<name>.awsapps.com/start`) and region, approve in the browser (device authorization, the same flow as `aws sso login`), then pick any **account** and **role** you can reach (type text to filter long lists). Tokens and temporary credentials stay in memory; nothing is written to disk.
+3. **Period** — last full month, current month, last 3/6/12 months, or a custom `YYYY-MM[:YYYY-MM]` range.
+
+For an existing SSO *profile* with an expired session it offers to run `aws sso login` for you (`--sso-login` does it without asking). Everything is also scriptable: `--sso-start-url … --sso-account <id|name> --sso-role <name>`; `-y/--yes` never prompts. Set `KIRO_REPORT_SSO_START_URL` to pre-fill the start URL.
+
+## Where the data comes from
+
+| Source | Gives you | How to enable |
+|---|---|---|
+| **Kiro user activity report** (daily CSVs in S3) | client type (IDE/CLI/Web), plan, credits, **overage**, messages, models, user e-mail, new users | Kiro console → *Settings* → *User activity report* → CSV → S3 bucket. [Docs](https://kiro.dev/docs/enterprise/monitor-and-track/user-activity/) |
+| **AWS Cost and Usage Report** (Data Exports, parquet) | real subscription lines, AWS credits applied, credits per Identity Center user (`line_item_resource_id`) | Billing → Data Exports → *Standard data export (CUR 2.0)* with resource IDs, parquet |
+| **IAM Identity Center** | user names when the activity report has no e-mail | automatic |
+
+Either source can be missing: with only the activity report, costs are *estimated at list price*; with only the CUR you get per-person credits and costs but no client/plan/model breakdown (the report tells you how to enable the rest). Sources are auto-discovered; override with `--cur-export`, `--cur-bucket/--cur-prefix`, `--activity-bucket/--activity-prefix`.
+
+Required AWS permissions are read-only — see [docs/PERMISSIONS.md](docs/PERMISSIONS.md).
+
+## Options
+
+| Flag | Purpose |
+|---|---|
+| `--profile`, `--region`, `--sso-login` | pick a local profile; refresh an expired SSO session |
+| `--sso-start-url`, `--sso-region`, `--sso-account`, `--sso-role` | sign in to any account through IAM Identity Center, no profile needed |
+| `--month`, `--since`/`--until`, `--last N` | period (default: last 3 months, or asked) |
+| `--no-cur`, `--no-activity` | skip a source |
+| `--lang en\|es` | report language (also switchable inside the report) |
+| `--anonymize` | replace users with `user-NN` before sharing |
+| `--brand`, `--logo`, `--no-logo`, `--no-embed-font` | white-label the report |
+| `--json FILE` | also dump the aggregated data (feed your own dashboards) |
+| `--demo` | synthetic data, no AWS |
+
+## How it works
+
+```
+CUR (parquet) ─┐                                   ┌─> report.html (inline CSS/JS/SVG, offline)
+               ├─> model.build_report (JSON) ──────┤
+Kiro CSVs ─────┘     merge by user id,             └─> --json
+IAM Identity Center   tier right-sizing
+```
+
+`src/kiro_report/`: `cli` (prompts) · `aws` (profiles/SSO) · `cur` · `activity` · `identity` · `model` (merge + recommendations) · `tiers` (plan catalogue) · `render` + `templates/report.html`.
+
+## Related AWS projects
+
+This tool is a lightweight, local alternative to heavier setups; use them if you need always-on dashboards:
+
+- [Kiro User Activity Dashboard](https://docs.aws.amazon.com/guidance/latest/cloud-intelligence-dashboards/kiro-user-activity-dashboard.html) (Cloud Intelligence Dashboards, QuickSight)
+- [`aws-samples/sample-kiro-cost-optimizer`](https://github.com/aws-samples/sample-kiro-cost-optimizer) (serverless, e-mail recommendations)
+- [`aws-samples/sample-kiro-user-analytics-dashboard`](https://github.com/aws-samples/sample-kiro-user-analytics-dashboard)
+
+## Privacy
+
+Reports contain user e-mails and usage. Generated `kiro-report-*.html/json` are git-ignored; use `--anonymize` before sharing. Nothing leaves your machine except the AWS API calls you authorise.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest --cov=kiro_report
+ruff check .
+```
+
+Plan prices/allowances live in `src/kiro_report/tiers.py` (Kiro pricing is subject to change).
+
+## Releasing
+
+Releases are published to PyPI by GitHub Actions with [Trusted Publishing](https://docs.pypi.org/trusted-publishers/) (OIDC, no stored tokens): `.github/workflows/release.yml`. To release, bump `version` in `pyproject.toml`, merge, then push a tag `vX.Y.Z` (the workflow refuses a tag that does not match the version). Run the workflow manually with target `testpypi` to rehearse.
+
+## License
+
+MIT for the code. The SysCu logo in `src/kiro_report/assets/` is a brand asset and is **not** covered by the MIT license (replace it with `--logo`, or drop it with `--no-logo`); the bundled Figtree font is SIL OFL 1.1. See `LICENSE` and `src/kiro_report/assets/NOTICE.md`.

syscu_kiro_report_usage-0.1.0/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "syscu-kiro-report-usage"
+version = "0.1.0"
+description = "Self-contained HTML report of Kiro usage and cost per IAM Identity Center user (AWS CUR + Kiro user activity report)."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+keywords = ["kiro", "aws", "finops", "cost", "usage", "report", "iam-identity-center"]
+dependencies = ["boto3>=1.34", "pyarrow>=14"]
+
+[project.urls]
+Homepage = "https://github.com/syscu-es/syscu-kiro-report-usage"
+Issues = "https://github.com/syscu-es/syscu-kiro-report-usage/issues"
+
+[project.optional-dependencies]
+dev = ["pytest>=8", "pytest-cov>=5", "ruff>=0.5"]
+
+[project.scripts]
+kiro-report = "kiro_report.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+kiro_report = ["assets/*", "templates/*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+markers = ["unit: fast tests with no AWS access"]
+
+[tool.ruff]
+line-length = 110
+src = ["src", "tests"]
+target-version = "py310"
+
+[tool.ruff.lint]
+# explicit so local and CI results never depend on a user-level ruff config
+select = ["F", "UP", "B"]

syscu_kiro_report_usage-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

syscu_kiro_report_usage-0.1.0/src/kiro_report/__init__.py

@@ -0,0 +1,3 @@
+"""Kiro usage and cost report generator."""
+
+__version__ = "0.1.0"

syscu_kiro_report_usage-0.1.0/src/kiro_report/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+raise SystemExit(main())

syscu_kiro_report_usage-0.1.0/src/kiro_report/activity.py

@@ -0,0 +1,224 @@
+"""Reader for the Kiro *user activity report* (daily CSVs delivered to S3).
+
+Enable it in the Kiro console (Settings -> User activity report, CSV). Kiro writes one
+CSV per client type and day under
+``<prefix>/AWSLogs/<account>/KiroLogs/user_report/<region>/<yyyy>/<mm>/<dd>/<hh>/``
+named ``KIRO_IDE_<account>_user_report_<yyyymmddhh00>.csv`` (``KIRO_CLI``/``KIRO_WEB``
+for the other clients). Header::
+
+    Date,UserId,Client_Type,Chat_Conversations,Credits_Used,Overage_Cap,
+    Overage_Credits_Used,Overage_Enabled,ProfileId,Subscription_Tier,Total_Messages,
+    New_User,User_Email,Usage_Limit,<model>_messages,...
+
+Model columns are dynamic (``auto_messages``, ``claude_sonnet_5_messages``, ...).
+"""
+from __future__ import annotations
+
+import csv
+import datetime as dt
+import io
+import re
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Any
+from collections.abc import Callable
+from collections.abc import Iterable
+
+from .periods import month_bounds
+
+KEY_RE = re.compile(
+    r"^(?P<base>.*?)AWSLogs/(?P<account>\d+)/KiroLogs/user_report/(?P<region>[^/]+)/"
+    r"(?P<y>\d{4})/(?P<m>\d{2})/(?P<d>\d{2})/(?P<h>\d{2})/"
+    r"(?P<client>[A-Z_]+?)_\d+_user_report_\d+(?:_part\d+)?\.csv$"
+)
+DEFAULT_MAX_SCAN = 5000
+_CACHE_SAFE_AFTER_DAYS = 2  # reports older than this are final and can be cached
+
+
+@dataclass(frozen=True)
+class ReportLocation:
+    bucket: str
+    base: str  # key prefix before "AWSLogs/" ('' or ending with '/')
+    account: str
+
+
+@dataclass(frozen=True)
+class Discovery:
+    location: ReportLocation | None
+    candidates: tuple[str, ...]  # buckets that looked like Kiro report buckets
+
+
+@dataclass(frozen=True)
+class ReportKey:
+    key: str
+    date: str
+    client: str
+
+
+@dataclass(frozen=True)
+class ActivityRow:
+    date: str
+    user_id: str
+    email: str
+    client: str
+    tier: str
+    credits: float
+    overage: float
+    messages: int
+    conversations: int
+    new_user: bool
+    models: tuple[tuple[str, int], ...]
+
+
+# --------------------------------------------------------------------------- #
+# Parsing
+# --------------------------------------------------------------------------- #
+def normalize_client(raw: str) -> str:
+    """'KIRO_IDE' -> 'IDE'."""
+    text = (raw or "").strip().upper()
+    return text[5:] if text.startswith("KIRO_") else (text or "UNKNOWN")
+
+
+def _num(value: Any) -> float:
+    try:
+        return float(str(value).replace(",", "").strip() or 0)
+    except ValueError:
+        return 0.0
+
+
+def _truthy(value: Any) -> bool:
+    return str(value).strip().lower() in {"true", "1", "yes", "y"}
+
+
+def parse_report(text: str, client_hint: str = "") -> list[ActivityRow]:
+    """Parse one activity CSV. Header names are matched case-insensitively."""
+    reader = csv.DictReader(io.StringIO(text.lstrip("")))
+    rows: list[ActivityRow] = []
+    for raw in reader:
+        row = {(k or "").strip().lower(): (v or "").strip() for k, v in raw.items()}
+        if not row.get("date") or not row.get("userid"):
+            continue
+        models = tuple(
+            (name[: -len("_messages")], int(_num(value)))
+            for name, value in row.items()
+            if name.endswith("_messages") and name != "total_messages" and _num(value) > 0
+        )
+        rows.append(
+            ActivityRow(
+                date=row["date"][:10],
+                user_id=row["userid"],
+                email=row.get("user_email", ""),
+                client=normalize_client(row.get("client_type") or client_hint),
+                tier=row.get("subscription_tier", ""),
+                credits=_num(row.get("credits_used")),
+                overage=_num(row.get("overage_credits_used")),
+                messages=int(_num(row.get("total_messages"))),
+                conversations=int(_num(row.get("chat_conversations"))),
+                new_user=_truthy(row.get("new_user", "")),
+                models=models,
+            )
+        )
+    return rows
+
+
+# --------------------------------------------------------------------------- #
+# S3 discovery and download
+# --------------------------------------------------------------------------- #
+def find_in_bucket(s3: Any, bucket: str, max_scan: int = DEFAULT_MAX_SCAN) -> ReportLocation | None:
+    """Scan up to ``max_scan`` keys of ``bucket`` for an activity-report object."""
+    scanned = 0
+    paginator = s3.get_paginator("list_objects_v2")
+    for page in paginator.paginate(Bucket=bucket):
+        for obj in page.get("Contents", []):
+            match = KEY_RE.match(obj["Key"])
+            if match:
+                return ReportLocation(bucket, match["base"], match["account"])
+            scanned += 1
+            if scanned >= max_scan:
+                return None
+    return None
+
+
+def discover(
+    s3: Any,
+    *,
+    bucket: str | None = None,
+    prefix: str | None = None,
+    account: str | None = None,
+    max_scan: int = DEFAULT_MAX_SCAN,
+) -> Discovery:
+    """Locate the activity reports.
+
+    With ``bucket`` (and optionally ``prefix``/``account``) only that bucket is checked;
+    otherwise every bucket whose name contains "kiro" is scanned.
+    """
+    if bucket and prefix is not None and account:
+        base = prefix if not prefix or prefix.endswith("/") else prefix + "/"
+        return Discovery(ReportLocation(bucket, base, account), (bucket,))
+    names = [bucket] if bucket else [
+        b["Name"] for b in s3.list_buckets().get("Buckets", []) if "kiro" in b["Name"].lower()
+    ]
+    for name in names:
+        location = find_in_bucket(s3, name, max_scan)
+        if location:
+            return Discovery(location, tuple(names))
+    return Discovery(None, tuple(names))
+
+
+def list_report_keys(s3: Any, location: ReportLocation, months: Iterable[str]) -> list[ReportKey]:
+    """List the report objects of the given months across every region."""
+    root = f"{location.base}AWSLogs/{location.account}/KiroLogs/user_report/"
+    paginator = s3.get_paginator("list_objects_v2")
+    regions = [
+        p["Prefix"]
+        for page in paginator.paginate(Bucket=location.bucket, Prefix=root, Delimiter="/")
+        for p in page.get("CommonPrefixes", [])
+    ]
+    keys: list[ReportKey] = []
+    for region in regions:
+        for month in months:
+            prefix = f"{region}{month[:4]}/{month[5:7]}/"
+            for page in paginator.paginate(Bucket=location.bucket, Prefix=prefix):
+                for obj in page.get("Contents", []):
+                    match = KEY_RE.match(obj["Key"])
+                    if match:
+                        date = f"{match['y']}-{match['m']}-{match['d']}"
+                        keys.append(ReportKey(obj["Key"], date, normalize_client(match["client"])))
+    return sorted(keys, key=lambda k: (k.date, k.client, k.key))
+
+
+def fetch_text(
+    s3: Any, bucket: str, item: ReportKey, cache: Path | None, today: dt.date
+) -> str:
+    """Download a report, caching it on disk once it is old enough to be final."""
+    target = cache / "activity" / bucket / item.key if cache else None
+    final = dt.date.fromisoformat(item.date) <= today - dt.timedelta(days=_CACHE_SAFE_AFTER_DAYS)
+    if target and final and target.exists():
+        return target.read_text(encoding="utf-8")
+    body = s3.get_object(Bucket=bucket, Key=item.key)["Body"].read().decode("utf-8-sig")
+    if target and final:
+        target.parent.mkdir(parents=True, exist_ok=True)
+        target.write_text(body, encoding="utf-8")
+    return body
+
+
+def load_activity(
+    s3: Any,
+    location: ReportLocation,
+    months: list[str],
+    *,
+    cache: Path | None = None,
+    today: dt.date | None = None,
+    progress: Callable[[str], None] = lambda _msg: None,
+) -> list[ActivityRow]:
+    """Fetch and parse every report of ``months``; rows outside the months are dropped."""
+    today = today or dt.date.today()
+    first, last = month_bounds(months[0])[0], month_bounds(months[-1])[1]
+    items = list_report_keys(s3, location, months)
+    progress(f"  activity: {len(items)} report file(s)")
+    rows: list[ActivityRow] = []
+    for item in items:
+        for row in parse_report(fetch_text(s3, location.bucket, item, cache, today), item.client):
+            if first.isoformat() <= row.date <= last.isoformat():
+                rows.append(row)
+    return rows

syscu_kiro_report_usage-0.1.0/src/kiro_report/assets/NOTICE.md

@@ -0,0 +1,9 @@
+# Bundled assets
+
+| File | What | License |
+|---|---|---|
+| `Figtree-Variable.woff2` | Figtree (variable, Latin subset) | SIL Open Font License 1.1 — https://github.com/erikdkennedy/figtree |
+| `logo-light.svg`, `logo-dark.svg` | SysCu logo (light / dark theme) | © SysCu. Not covered by the MIT license of this repository. |
+
+Replace the logo with `--logo your-logo.svg`, rename the brand with `--brand "Your Name"`,
+or drop it with `--no-logo`. Skip the font with `--no-embed-font`.

syscu_kiro_report_usage-0.1.0/src/kiro_report/assets/logo-dark.svg

@@ -0,0 +1,13 @@
+<svg id="Capa_2" data-name="Capa 2" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 918.23 714.18"><defs><style>
+      .cls-1 {
+        fill: #fff;
+      }
+
+      .cls-2 {
+        fill: #00a7e1;
+      }
+
+      .cls-3 {
+        fill: #002b49;
+      }
+    </style></defs><g id="Capa_1-2" data-name="Capa 1"><g><path class="cls-1" d="m918.23,459.11c0,140.85-114.22,255.06-255.06,255.06H255.06C114.22,714.18,0,599.96,0,459.11c0-124.88,89.83-228.79,208.39-250.73C230.32,89.83,334.23,0,459.11,0s228.79,89.83,250.73,208.39c118.55,21.94,208.39,125.85,208.39,250.73Z"/><path class="cls-2" d="m459.11,612.15h-204.05c-84.53,0-153.04-68.51-153.04-153.04,0-69.07,45.76-127.43,108.66-146.46,22.65,98.2,102.03,174.67,201.75,193.13,7.29,39.38,23.57,75.55,46.68,106.36Z"/><path class="cls-3" d="m816.2,459.11c0,84.53-68.51,153.04-153.04,153.04-66.62,0-123.3-42.6-144.31-102.03h144.31c28.16,0,51.01-22.85,51.01-51.01s-22.85-51.01-51.01-51.01h-204.05c-84.53,0-153.04-68.51-153.04-153.04s68.51-153.04,153.04-153.04c66.62,0,123.3,42.6,144.31,102.03h-144.31c-28.16,0-51.01,22.85-51.01,51.01s22.85,51.01,51.01,51.01h204.05c84.53,0,153.04,68.51,153.04,153.04Z"/></g></g></svg>

syscu_kiro_report_usage-0.1.0/src/kiro_report/assets/logo-light.svg

@@ -0,0 +1,13 @@
+<svg id="Capa_2" data-name="Capa 2" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 918.23 714.18"><defs><style>
+      .cls-1 {
+        fill: #fff;
+      }
+
+      .cls-2 {
+        fill: #00a7e1;
+      }
+
+      .cls-3 {
+        fill: #002b49;
+      }
+    </style></defs><g id="Capa_1-2" data-name="Capa 1"><g><path class="cls-3" d="m918.23,459.11c0,140.85-114.22,255.06-255.06,255.06H255.06C114.22,714.18,0,599.96,0,459.11c0-124.88,89.83-228.79,208.39-250.73C230.32,89.83,334.23,0,459.11,0s228.79,89.83,250.73,208.39c118.55,21.94,208.39,125.85,208.39,250.73Z"/><path class="cls-2" d="m459.11,612.15h-204.05c-84.53,0-153.04-68.51-153.04-153.04,0-69.07,45.76-127.43,108.66-146.46,22.65,98.2,102.03,174.67,201.75,193.13,7.29,39.38,23.57,75.55,46.68,106.36Z"/><path class="cls-1" d="m816.2,459.11c0,84.53-68.51,153.04-153.04,153.04-66.62,0-123.3-42.6-144.31-102.03h144.31c28.16,0,51.01-22.85,51.01-51.01s-22.85-51.01-51.01-51.01h-204.05c-84.53,0-153.04-68.51-153.04-153.04s68.51-153.04,153.04-153.04c66.62,0,123.3,42.6,144.31,102.03h-144.31c-28.16,0-51.01,22.85-51.01,51.01s22.85,51.01,51.01,51.01h204.05c84.53,0,153.04,68.51,153.04,153.04Z"/></g></g></svg>