clean up content

Author: clean6378-max-it

.github/workflows/release.yml

@@ -1,17 +1,14 @@
 name: Release
 
-# Fires when a version tag is pushed (for example v0.2.1).
-# Builds hatchling wheel + sdist and a Windows PyInstaller zip, then attaches
-# all three as GitHub Release assets via softprops/action-gh-release.
+# v* tag push: build wheel, sdist, and Windows zip; publish attaches all three to the Release.
+# workflow_dispatch runs the build jobs only (no publish).
 #
-# Expected asset names (version comes from pyproject.toml at the tagged commit):
+# Asset names (version from pyproject.toml at the tagged commit):
 #   cppa_cursor_browser-<version>-py3-none-any.whl   (~154 KiB at 0.2.0)
-#   cppa_cursor_browser-<version>.tar.gz               (~225 KiB at 0.2.0)
-#   CursorChatBrowser-windows.zip                      (PyInstaller onedir bundle)
+#   cppa_cursor_browser-<version>.tar.gz             (~225 KiB at 0.2.0)
+#   CursorChatBrowser-windows.zip
 #
-# Fork verification: push a test tag (for example v0.0.0-test) and confirm the
-# workflow attaches all three files to the resulting Release.
-# workflow_dispatch runs build-python + build-windows only (publish is tag-only).
+# Fork check: push v0.0.0-test and confirm all three files on the Release.
 
 on:
   push:
@@ -68,8 +65,7 @@ jobs:
           python-version: "3.12"
 
       - name: Install runtime dependencies
-        # Lock file for Flask/runtime deps; pywebview is the [desktop] extra and
-        # is required so the published exe can open its native window.
+        # requirements-lock.txt for runtime; pywebview for the desktop window.
         run: |
           python -m pip install --upgrade pip
           python -m pip install -r requirements-lock.txt

.github/workflows/tests.yml

@@ -120,7 +120,7 @@ jobs:
       # ── PyInstaller desktop build (Windows only, once per workflow) ────────
       # Closes #44. Builds the onedir bundle and smoke-tests --help so the
       # desktop entry point is verified without launching the GUI window.
-      # pywebview matches release.yml so CI bundles the same graph we ship.
+      # pywebview matches release.yml so the Windows bundle matches what we ship.
       - name: Install pywebview for PyInstaller bundle
         if: matrix.os == 'windows-latest' && matrix.python-version == '3.12'
         run: python -m pip install 'pywebview>=5.0,<7'

README.md

@@ -265,15 +265,15 @@ Notable changes will be documented in **[CHANGELOG.md](CHANGELOG.md)** following
 
 ### GitHub Releases
 
-Pushing a tag matching `v*` (for example `v0.2.1`) runs [`.github/workflows/release.yml`](.github/workflows/release.yml), which attaches three assets to the GitHub Release. Set `[project].version` in `pyproject.toml` to match the tag before you push (for example tag `v0.2.1` requires `version = "0.2.1"`); hatchling names the wheel and sdist from pyproject, not from the git tag.
+Push a `v*` tag (for example `v0.2.1`) to run [`.github/workflows/release.yml`](.github/workflows/release.yml). It uploads three assets to the GitHub Release. Set `[project].version` in `pyproject.toml` to match the tag before you push (`v0.2.1` needs `version = "0.2.1"`). Hatchling names the wheel and sdist from pyproject, not the git tag.
 
 | Asset | Contents |
 |---|---|
 | `cppa_cursor_browser-<version>-py3-none-any.whl` | Installable wheel (hatchling build) |
 | `cppa_cursor_browser-<version>.tar.gz` | Source distribution |
 | `CursorChatBrowser-windows.zip` | Windows PyInstaller onedir bundle (`CursorChatBrowser.exe` plus supporting files) |
 
-At `0.2.0`, local `python -m build` produced a ~154 KiB wheel and ~225 KiB sdist; the Windows zip size depends on the locked dependency tree at tag time. Copy release notes from the matching `[version]` section in `CHANGELOG.md` when publishing the GitHub Release.
+At `0.2.0`, a local `python -m build` gave a ~154 KiB wheel and ~225 KiB sdist. Windows zip size varies with the locked tree at tag time. Paste release notes from the matching `[version]` section in `CHANGELOG.md`.
 
 When an API surface is scheduled for removal, follow the process in **[docs/API_DEPRECATION.md](docs/API_DEPRECATION.md)** (response headers, changelog entries, minimum notice period).
 

cursor-browser.spec

@@ -17,7 +17,7 @@ a = Analysis(
         (str(src / "static"), "static"),
     ],
     hiddenimports=[
-        "webview",  # pywebview must be installed at build time; hiddenimport alone is not enough
+        "webview",  # needs pywebview installed at build time
         "api.workspaces",
         "api.composers",
         "api.logs",