bugcap 0.5.0__tar.gz → 0.6.0__tar.gz

{bugcap-0.5.0/src/bugcap.egg-info → bugcap-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bugcap
-Version: 0.5.0
+Version: 0.6.0
 Summary: Local-first, agent-readable bug capture: annotated screenshots + notes, stored locally, synced to trackers on your own schedule.
 Author: Konrad Tagnon Amen ALAHASSA
 License: MIT
@@ -12,10 +12,11 @@ Provides-Extra: mcp
 Requires-Dist: mcp<2,>=1.2; extra == "mcp"
 Provides-Extra: dev
 Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
 Dynamic: license-file
 
 <p align="center">
-  <img src="docs/assets/logo.svg" alt="bugcap" width="96">
+  <img src="https://raw.githubusercontent.com/amenalahassa/bugcap/master/docs/assets/logo.svg" alt="bugcap" width="96">
 </p>
 
 <h1 align="center">bugcap</h1>
@@ -28,7 +29,7 @@ Dynamic: license-file
 <p align="center">
   <a href="https://github.com/amenalahassa/bugcap/actions/workflows/release.yml"><img alt="tests" src="https://github.com/amenalahassa/bugcap/actions/workflows/release.yml/badge.svg"></a>
   <img alt="python" src="https://img.shields.io/badge/python-3.10%2B-3776ab?logo=python&logoColor=white">
-  <a href="LICENSE"><img alt="license" src="https://img.shields.io/badge/license-MIT-green"></a>
+  <a href="https://github.com/amenalahassa/bugcap/blob/master/LICENSE"><img alt="license" src="https://img.shields.io/badge/license-MIT-green"></a>
   <a href="https://amenalahassa.github.io/bugcap/"><img alt="docs" src="https://img.shields.io/badge/docs-website-d9480f"></a>
 </p>
 
@@ -37,11 +38,11 @@ Dynamic: license-file
   <a href="https://amenalahassa.github.io/bugcap/usage.html">Usage guide</a> ·
   <a href="#quick-start">Quick start</a> ·
   <a href="#connect-your-agent-mcp">Agents (MCP)</a> ·
-  <a href="CHANGELOG.md">Changelog</a>
+  <a href="https://github.com/amenalahassa/bugcap/blob/master/CHANGELOG.md">Changelog</a>
 </p>
 
 <p align="center">
-  <img src="docs/assets/demo.gif" alt="bugcap capturing an annotated bug and listing the report" width="760">
+  <img src="https://raw.githubusercontent.com/amenalahassa/bugcap/master/docs/assets/demo.gif" alt="bugcap live: screenshot a broken page, file a bug with a note, then read it back with bugcap show" width="760">
 </p>
 
 ---
@@ -82,6 +83,8 @@ bugcap dashboard --open                 # browse and triage in the browser
 The [usage guide](https://amenalahassa.github.io/bugcap/usage.html) covers every command: images
 and labels, recording, live mode, `@` references, GitHub pull and sync, and the MCP tools.
 
+If a report ID is not found, the error suggests `bugcap list --all` to see report IDs across all repos.
+
 ## Connect your agent (MCP)
 
 Requires the `mcp` extra. Then give your agent access to the reports:
@@ -97,7 +100,7 @@ Or in a project's `.mcp.json`:
 ```
 
 The server exposes six tools: `list_reports`, `get_report` (returns the screenshot), `request_screenshot`,
-`pull_issues`, `attach_image` and `update_notes`. Logs go to `logs/mcp-server.log` in the data
+`pull_issues`, `attach_image`, `attach_file` and `update_notes`. Logs go to `logs/mcp-server.log` in the data
 directory, never to stdout.
 
 Ask your agent something like *"list the open bugcap reports for this repo and fix the one with
@@ -120,7 +123,7 @@ the error toast"*. It can read the picture because it's a local file, not a CDN
 Working. Roadmap items 1–5, 7 and 8 are implemented and tested, along with spec 002 (images,
 `@` references, recording, live mode and the dashboard). S3/R2 object storage (item 6) and other
 trackers (item 9) are deferred. The `Destination` seam is in place, so they can be added without
-changing the CLI. See [ROADMAP.md](ROADMAP.md).
+changing the CLI. See [ROADMAP.md](https://github.com/amenalahassa/bugcap/blob/master/ROADMAP.md).
 
 ## Installation
 
@@ -146,13 +149,17 @@ pull and sync, MCP, and where data lives per OS.
 
 Notes on the more involved behaviour:
 
-- **References.** In a note, `@i1` is image 1, `@v2` a video, `@g3` an animated GIF, `@f4` a frame set, and `@login-error` a labelled item. `#3` points at report 3 (a missing one is kept as text with a warning). Media references are validated on save, and relabelling or removing a referenced item needs `--force`.
+- **References.** In a note, `@i1` is image 1, `@v2` a video, `@g3` an animated GIF, `@f4` a frame set, `@d5` an attached file (`attach --file`, any type), and `@login-error` a labelled item. `#3` points at report 3 (a missing one is kept as text with a warning). Media references are validated on save, and relabelling or removing a referenced item needs `--force`.
 - **Repo values** (`init`, `sync`, `config repo set`) are checked for format and, with `gh`, for existence. Changing the repo identity offers to move existing reports.
 - **Media sync** over `[sync] max_upload_mb` (default 25) is skipped with a warning.
 
+## Contributing
+
+Contributions are welcome. Read [CONTRIBUTING.md](https://github.com/amenalahassa/bugcap/blob/master/CONTRIBUTING.md) for the workflow and project rules, and the [Code of Conduct](https://github.com/amenalahassa/bugcap/blob/master/CODE_OF_CONDUCT.md). Report security issues privately, see [SECURITY.md](https://github.com/amenalahassa/bugcap/blob/master/SECURITY.md).
+
 ## Development
 
-See [DEVELOPMENT.md](DEVELOPMENT.md). Run the tests with:
+See [DEVELOPMENT.md](https://github.com/amenalahassa/bugcap/blob/master/DEVELOPMENT.md). Run the tests with:
 
 ```bash
 uv run --extra dev --extra mcp pytest -q
@@ -203,7 +210,7 @@ succeeds, so a re-run skips what is already recorded.
 
 ## Roadmap
 
-See [ROADMAP.md](ROADMAP.md).
+See [ROADMAP.md](https://github.com/amenalahassa/bugcap/blob/master/ROADMAP.md).
 
 ## Design notes / deliberate non-goals
 
@@ -222,4 +229,4 @@ See [ROADMAP.md](ROADMAP.md).
 
 ## License
 
-MIT — see [LICENSE](LICENSE).
+MIT — see [LICENSE](https://github.com/amenalahassa/bugcap/blob/master/LICENSE).

{bugcap-0.5.0 → bugcap-0.6.0}/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="docs/assets/logo.svg" alt="bugcap" width="96">
+  <img src="https://raw.githubusercontent.com/amenalahassa/bugcap/master/docs/assets/logo.svg" alt="bugcap" width="96">
 </p>
 
 <h1 align="center">bugcap</h1>
@@ -12,7 +12,7 @@
 <p align="center">
   <a href="https://github.com/amenalahassa/bugcap/actions/workflows/release.yml"><img alt="tests" src="https://github.com/amenalahassa/bugcap/actions/workflows/release.yml/badge.svg"></a>
   <img alt="python" src="https://img.shields.io/badge/python-3.10%2B-3776ab?logo=python&logoColor=white">
-  <a href="LICENSE"><img alt="license" src="https://img.shields.io/badge/license-MIT-green"></a>
+  <a href="https://github.com/amenalahassa/bugcap/blob/master/LICENSE"><img alt="license" src="https://img.shields.io/badge/license-MIT-green"></a>
   <a href="https://amenalahassa.github.io/bugcap/"><img alt="docs" src="https://img.shields.io/badge/docs-website-d9480f"></a>
 </p>
 
@@ -21,11 +21,11 @@
   <a href="https://amenalahassa.github.io/bugcap/usage.html">Usage guide</a> ·
   <a href="#quick-start">Quick start</a> ·
   <a href="#connect-your-agent-mcp">Agents (MCP)</a> ·
-  <a href="CHANGELOG.md">Changelog</a>
+  <a href="https://github.com/amenalahassa/bugcap/blob/master/CHANGELOG.md">Changelog</a>
 </p>
 
 <p align="center">
-  <img src="docs/assets/demo.gif" alt="bugcap capturing an annotated bug and listing the report" width="760">
+  <img src="https://raw.githubusercontent.com/amenalahassa/bugcap/master/docs/assets/demo.gif" alt="bugcap live: screenshot a broken page, file a bug with a note, then read it back with bugcap show" width="760">
 </p>
 
 ---
@@ -66,6 +66,8 @@ bugcap dashboard --open                 # browse and triage in the browser
 The [usage guide](https://amenalahassa.github.io/bugcap/usage.html) covers every command: images
 and labels, recording, live mode, `@` references, GitHub pull and sync, and the MCP tools.
 
+If a report ID is not found, the error suggests `bugcap list --all` to see report IDs across all repos.
+
 ## Connect your agent (MCP)
 
 Requires the `mcp` extra. Then give your agent access to the reports:
@@ -81,7 +83,7 @@ Or in a project's `.mcp.json`:
 ```
 
 The server exposes six tools: `list_reports`, `get_report` (returns the screenshot), `request_screenshot`,
-`pull_issues`, `attach_image` and `update_notes`. Logs go to `logs/mcp-server.log` in the data
+`pull_issues`, `attach_image`, `attach_file` and `update_notes`. Logs go to `logs/mcp-server.log` in the data
 directory, never to stdout.
 
 Ask your agent something like *"list the open bugcap reports for this repo and fix the one with
@@ -104,7 +106,7 @@ the error toast"*. It can read the picture because it's a local file, not a CDN
 Working. Roadmap items 1–5, 7 and 8 are implemented and tested, along with spec 002 (images,
 `@` references, recording, live mode and the dashboard). S3/R2 object storage (item 6) and other
 trackers (item 9) are deferred. The `Destination` seam is in place, so they can be added without
-changing the CLI. See [ROADMAP.md](ROADMAP.md).
+changing the CLI. See [ROADMAP.md](https://github.com/amenalahassa/bugcap/blob/master/ROADMAP.md).
 
 ## Installation
 
@@ -130,13 +132,17 @@ pull and sync, MCP, and where data lives per OS.
 
 Notes on the more involved behaviour:
 
-- **References.** In a note, `@i1` is image 1, `@v2` a video, `@g3` an animated GIF, `@f4` a frame set, and `@login-error` a labelled item. `#3` points at report 3 (a missing one is kept as text with a warning). Media references are validated on save, and relabelling or removing a referenced item needs `--force`.
+- **References.** In a note, `@i1` is image 1, `@v2` a video, `@g3` an animated GIF, `@f4` a frame set, `@d5` an attached file (`attach --file`, any type), and `@login-error` a labelled item. `#3` points at report 3 (a missing one is kept as text with a warning). Media references are validated on save, and relabelling or removing a referenced item needs `--force`.
 - **Repo values** (`init`, `sync`, `config repo set`) are checked for format and, with `gh`, for existence. Changing the repo identity offers to move existing reports.
 - **Media sync** over `[sync] max_upload_mb` (default 25) is skipped with a warning.
 
+## Contributing
+
+Contributions are welcome. Read [CONTRIBUTING.md](https://github.com/amenalahassa/bugcap/blob/master/CONTRIBUTING.md) for the workflow and project rules, and the [Code of Conduct](https://github.com/amenalahassa/bugcap/blob/master/CODE_OF_CONDUCT.md). Report security issues privately, see [SECURITY.md](https://github.com/amenalahassa/bugcap/blob/master/SECURITY.md).
+
 ## Development
 
-See [DEVELOPMENT.md](DEVELOPMENT.md). Run the tests with:
+See [DEVELOPMENT.md](https://github.com/amenalahassa/bugcap/blob/master/DEVELOPMENT.md). Run the tests with:
 
 ```bash
 uv run --extra dev --extra mcp pytest -q
@@ -187,7 +193,7 @@ succeeds, so a re-run skips what is already recorded.
 
 ## Roadmap
 
-See [ROADMAP.md](ROADMAP.md).
+See [ROADMAP.md](https://github.com/amenalahassa/bugcap/blob/master/ROADMAP.md).
 
 ## Design notes / deliberate non-goals
 
@@ -206,4 +212,4 @@ See [ROADMAP.md](ROADMAP.md).
 
 ## License
 
-MIT — see [LICENSE](LICENSE).
+MIT — see [LICENSE](https://github.com/amenalahassa/bugcap/blob/master/LICENSE).

{bugcap-0.5.0 → bugcap-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bugcap"
-version = "0.5.0"
+version = "0.6.0"
 description = "Local-first, agent-readable bug capture: annotated screenshots + notes, stored locally, synced to trackers on your own schedule."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -14,7 +14,7 @@ dependencies = ["tomli>=2; python_version < '3.11'"]
 
 [project.optional-dependencies]
 mcp = ["mcp>=1.2,<2"]
-dev = ["pytest>=7"]
+dev = ["pytest>=7", "ruff>=0.6"]
 
 [project.scripts]
 bugcap = "bugcap.cli:main"
@@ -27,3 +27,13 @@ bugcap = ["dashboard/static/*"]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E4", "E7", "E9", "F", "I"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["E702", "E731"]

bugcap-0.6.0/src/bugcap/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.6.0"

{bugcap-0.5.0 → bugcap-0.6.0}/src/bugcap/agent_api.py

@@ -97,10 +97,19 @@ def get_report(store: Store, id: int) -> dict:
 
 def attach_image(store: Store, id: int, sources: list[str], labels: Optional[list] = None) -> dict:
     """Attach images (paths, globs, http(s) URLs) to a report; partial batches are reported."""
+    return _attach(store, id, sources, labels, service.add_media)
+
+
+def attach_file(store: Store, id: int, sources: list[str], labels: Optional[list] = None) -> dict:
+    """Attach files of any type (paths, globs, http(s) URLs) to a report."""
+    return _attach(store, id, sources, labels, service.add_files)
+
+
+def _attach(store: Store, id: int, sources: list[str], labels, add) -> dict:
     if not sources or len(sources) > 20:
         return {"code": "bad_query", "error": "sources must contain 1 to 20 entries"}
     try:
-        result = service.add_media(store, id, list(sources), labels)
+        result = add(store, id, list(sources), labels)
     except ServiceError as exc:
         return {"error": exc.message, **exc.as_dict()}
     return {

{bugcap-0.5.0 → bugcap-0.6.0}/src/bugcap/backends.py

@@ -95,8 +95,51 @@ def by_name(name: str) -> Backend:
     raise KeyError(name)
 
 
+def _sync_path_from_registry() -> None:
+    """Pick up a freshly-installed Windows tool without a new terminal.
+
+    winget/scoop/choco update the user/machine PATH in the registry, but an
+    already-running process (and any shell that was already open when the
+    install happened) keeps its original PATH until it restarts. That made
+    `bugcap live` report "No capture tool found" right after `bugcap setup`
+    had just installed flameshot in the same session. Re-reading PATH from
+    the registry before every detection closes that gap. Best-effort: any
+    failure here just leaves PATH as-is.
+    """
+    if sys.platform != "win32":
+        return
+    try:
+        import winreg
+    except ImportError:
+        return
+    try:
+        chunks = [os.environ.get("PATH", "")]
+        for hive, subkey in (
+            (winreg.HKEY_CURRENT_USER, r"Environment"),
+            (winreg.HKEY_LOCAL_MACHINE, r"SYSTEM\CurrentControlSet\Control\Session Manager\Environment"),
+        ):
+            try:
+                with winreg.OpenKey(hive, subkey) as key:
+                    value, _ = winreg.QueryValueEx(key, "Path")
+                    chunks.append(value)
+            except OSError:
+                continue
+        seen = set()
+        merged = []
+        for chunk in chunks:
+            for part in chunk.split(os.pathsep):
+                key = part.lower()
+                if part and key not in seen:
+                    seen.add(key)
+                    merged.append(part)
+        os.environ["PATH"] = os.pathsep.join(merged)
+    except OSError:
+        pass
+
+
 def detect() -> Optional[Backend]:
     """First available backend, in preference order."""
+    _sync_path_from_registry()
     return next((b for b in BACKENDS if b.available()), None)
 
 

{bugcap-0.5.0 → bugcap-0.6.0}/src/bugcap/cli.py

@@ -7,13 +7,12 @@ import threading
 from pathlib import Path
 from typing import Optional
 
-from . import backends, capture, config, ghcli, recorder, refs, repo, service, sync, validation
+from . import __version__, backends, capture, config, ghcli, recorder, refs, repo, service, sync, validation
 from .capture import CaptureError
 from .errors import ServiceError
 from .ghcli import GhError
 from .store import STATUSES, Store
 
-
 # --- shared helpers (T014) ----------------------------------------------------
 
 def current_repo():
@@ -25,7 +24,10 @@ def resolve_report(store: Store, report_id: int):
     """Return the report, or print the standard not-found error and return None."""
     report = store.get(report_id)
     if report is None:
-        print(f"error: no report with id {report_id}", file=sys.stderr)
+        print(
+            f"error: no report with id {report_id}; run `bugcap list --all` to see report ids",
+            file=sys.stderr,
+        )
     return report
 
 
@@ -41,7 +43,7 @@ def print_service_error(exc: ServiceError) -> None:
 def print_ingest(added, rejected) -> None:
     """One line per input: `added #<idx> ...` on stdout, `skipped ...` on stderr."""
     for media in added:
-        name = os.path.basename(media.path or "")
+        name = os.path.basename((media.source if media.kind == "file" and media.source else media.path) or "")
         print(f"added {refs.media_token(media)} {name} ({media.kind}, {human_size(media.size_bytes)})")
     for item in rejected:
         print(f"skipped {item['source']}: {item['reason']}", file=sys.stderr)
@@ -161,7 +163,7 @@ def print_report(report) -> None:
         print(f"  repo:       {report.repo}")
     print(f"  tags:       {', '.join(report.tags) or '(none)'}")
     print(f"  notes:      {refs.display_notes(report.notes, report.media) or '(none)'}")
-    print(f"  images:")
+    print("  images:")
     for path in report.image_paths:
         print(f"    - {path}")
     detailed = [m for m in report.media if not (m.kind == "image" and m.source == "legacy")]
@@ -171,7 +173,7 @@ def print_report(report) -> None:
             where = m.path or f"({len(m.frames)} frames)"
             origin = f"  (source: {m.source})" if m.source else ""
             print(f"    {refs.media_token(m)}  {m.kind:8s} {m.label or '-':12s} {where}  {human_size(m.size_bytes)}{origin}")
-    print(f"  synced_refs:")
+    print("  synced_refs:")
     if report.synced_refs:
         for tracker, ref in report.synced_refs.items():
             print(f"    - {tracker}: {ref}")
@@ -226,7 +228,13 @@ def _setup_capture(args: argparse.Namespace) -> int:
     if rc != 0:
         print(f"error: install command failed (exit {rc}).", file=sys.stderr)
         return 1
-    print(f"{rec.name} installed.")
+    if backends.detect() is not None:
+        print(f"{rec.name} installed.")
+        return 0
+    print(
+        f"{rec.name} installed, but this terminal can't see it on PATH yet.\n"
+        f"Close and reopen your terminal (or start a new one), then run `bugcap setup` again."
+    )
     return 0
 
 
@@ -537,14 +545,22 @@ def cmd_attach(args: argparse.Namespace) -> int:
         added: list = []
         rejected: list = []
         shot_path = None
-        if args.image:
-            try:
-                result = service.add_media(store, args.id, list(args.image), labels)
-            except ServiceError as exc:
-                print_service_error(exc)
-                return 1
-            added, rejected = result.added, result.rejected
-            print_ingest(added, rejected)
+        if args.image or args.file:
+            batches = (
+                (args.image, service.add_media, labels),
+                (args.file, service.add_files, list(args.file_label or [])),
+            )
+            for sources, add, batch_labels in batches:
+                if not sources:
+                    continue
+                try:
+                    result = add(store, args.id, list(sources), batch_labels)
+                except ServiceError as exc:
+                    print_service_error(exc)
+                    return 1
+                added += result.added
+                rejected += result.rejected
+                print_ingest(result.added, result.rejected)
         else:
             try:
                 shot_path = capture.capture_screenshot()
@@ -569,7 +585,7 @@ def cmd_attach(args: argparse.Namespace) -> int:
                 return 1
         current = store.get(args.id)
         _warn_report_refs(store, current.notes)
-        if args.image:
+        if args.image or args.file:
             try:
                 refs.validate_references(current.notes, current.media)
             except ServiceError as exc:
@@ -850,6 +866,7 @@ def build_parser() -> argparse.ArgumentParser:
         prog="bugcap",
         description="Local-first, agent-readable bug capture: annotated screenshots + notes.",
     )
+    parser.add_argument("--version", action="version", version=f"bugcap {__version__}")
     sub = parser.add_subparsers(dest="command", required=True)
 
     p = sub.add_parser("setup", help="Detect a capture tool, or recommend/install one.")
@@ -901,12 +918,16 @@ def build_parser() -> argparse.ArgumentParser:
     p.add_argument("tags", nargs="+")
     p.set_defaults(func=cmd_tag)
 
-    p = sub.add_parser("attach", help="Attach a screenshot (captured or imported) to a report.")
+    p = sub.add_parser("attach", help="Attach a screenshot (captured or imported) or any file to a report.")
     p.add_argument("id", type=int)
     p.add_argument("--image", action="append", metavar="SRC",
                    help="Import an image (path, glob or http(s) URL) instead of launching a capture tool; repeatable.")
     p.add_argument("--label", action="append", help="Label for the --image at the same position (repeatable).")
-    p.add_argument("--note", help="Text appended to the report's notes, tied to the image(s) added here.")
+    p.add_argument("--file", action="append", metavar="SRC",
+                   help="Attach a file of any type (path, glob or http(s) URL); repeatable. "
+                        "Refer to it in notes as @d1, @d2, ... or by label.")
+    p.add_argument("--file-label", action="append", help="Label for the --file at the same position (repeatable).")
+    p.add_argument("--note", help="Text appended to the report's notes, tied to the item(s) added here.")
     p.set_defaults(func=cmd_attach)
 
     p = sub.add_parser("images", help="List a report's images, or relabel/remove one.")
@@ -982,7 +1003,27 @@ def build_parser() -> argparse.ArgumentParser:
     return parser
 
 
+def _use_utf8_streams() -> None:
+    """Make stdout/stderr tolerant of report text the console's codepage can't show.
+
+    Report titles and notes are free-form user text and may contain characters
+    (accents, emoji, …) outside the active console codepage. On Windows that
+    codepage is often cp1252, so a bare `print()` of such text raises
+    UnicodeEncodeError and crashes the CLI (e.g. `bugcap show`). Reconfiguring
+    to UTF-8 with 'replace' keeps the command running and shows readable output
+    instead of a traceback.
+    """
+    for stream in (sys.stdout, sys.stderr):
+        reconfigure = getattr(stream, "reconfigure", None)
+        if reconfigure is not None:
+            try:
+                reconfigure(encoding="utf-8", errors="replace")
+            except (ValueError, OSError):
+                pass
+
+
 def main(argv: list[str] | None = None) -> int:
+    _use_utf8_streams()
     parser = build_parser()
     args = parser.parse_args(argv)
     return args.func(args)

{bugcap-0.5.0 → bugcap-0.6.0}/src/bugcap/dashboard/media.py

@@ -31,8 +31,10 @@ def parse_range(header: str | None, size: int):
     return start, min(end, size - 1)
 
 
-def serve_media(handler, rel_path, mime: str, range_header: str | None) -> None:
-    """`rel_path` is the stored data-relative path; it must resolve inside images/ or media/."""
+def serve_media(handler, rel_path, mime: str, range_header: str | None, download_name: str | None = None) -> None:
+    """`rel_path` is the stored data-relative path; it must resolve inside the media store.
+    With `download_name` (attached files of any type) the bytes are always sent as an opaque
+    download, never rendered, so an uploaded HTML or SVG file cannot run on the dashboard origin."""
     try:
         path = resolve_data_path(rel_path)
         if not path.is_file():
@@ -53,7 +55,12 @@ def serve_media(handler, rel_path, mime: str, range_header: str | None) -> None:
     start, end = rng if rng else (0, size - 1)
     handler.send_response(206 if rng else 200)
     handler.send_security_headers()
-    handler.send_header("Content-Type", mime)
+    if download_name is not None:
+        safe = re.sub(r"[^A-Za-z0-9._-]", "_", download_name)[:100] or "file"
+        handler.send_header("Content-Type", "application/octet-stream")
+        handler.send_header("Content-Disposition", f'attachment; filename="{safe}"')
+    else:
+        handler.send_header("Content-Type", mime)
     handler.send_header("Accept-Ranges", "bytes")
     handler.send_header("Cache-Control", "private, max-age=3600")
     handler.send_header("Content-Length", str(end - start + 1) if size else "0")

{bugcap-0.5.0 → bugcap-0.6.0}/src/bugcap/dashboard/server.py

@@ -7,6 +7,7 @@ from __future__ import annotations
 
 import hmac
 import json
+import os
 import re
 import secrets
 import sys
@@ -182,7 +183,10 @@ class Handler(BaseHTTPRequestHandler):
         if frame_no is None:
             if media.kind == "frames" or not media.path:
                 return self.send_json(404, {"code": "not_found", "message": "media not found"})
-            return serve_media(self, media.path, media.mime, self.headers.get("Range"))
+            name = None
+            if media.kind == "file":
+                name = os.path.basename((media.source or "").replace("\\", "/")) or os.path.basename(media.path)
+            return serve_media(self, media.path, media.mime, self.headers.get("Range"), name)
         frame = next((f for f in media.frames if f.frame_no == frame_no), None)
         if frame is None:
             return self.send_json(404, {"code": "not_found", "message": "frame not found"})

{bugcap-0.5.0 → bugcap-0.6.0}/src/bugcap/dashboard/static/app.js

@@ -90,11 +90,15 @@
         var img = document.createElement("img");
         img.src = f.url; img.alt = "frame " + f.frame_no; fig.appendChild(img);
       });
+    } else if (m.kind === "file") {
+      var a = document.createElement("a");
+      a.href = m.url; a.download = ""; a.textContent = "Download " + (m.label || ("file " + m.index));
+      fig.appendChild(a);
     } else {
       var i = document.createElement("img");
       i.src = m.url; i.alt = m.label || ("image " + m.index); fig.appendChild(i);
     }
-    var letters = {image: "i", video: "v", animated: "g", frames: "f"};
+    var letters = {image: "i", video: "v", animated: "g", frames: "f", file: "d"};
     var label = caption || ("@" + (letters[m.kind] || "i") + m.index);
     if (m.label) label += " (" + m.label + ")";
     fig.appendChild(el("figcaption", label + " · " + m.kind + " · " + Math.round(m.size_bytes / 1024) + " KB"));