Merge branch 'main' into qvac-b9518

Author: zoq

.cursor/rules/sdk/example.mdc

@@ -5,10 +5,24 @@ alwaysApply: false
 ---
 - All example files should have consistent error handling using try-catch blocks with process.exit(0) on success and process.exit(1) on error
 - Use top-level await with try-catch instead of async function wrappers
-- Error messages should use: `console.error("❌ Error:", error)`
 - Examples can use plain `Error` objects (they're user-facing demos, not SDK code)
 - All example files which load models should have an unloadModel call to unload the model when done
+- Logging convention (uniform across all examples):
+  - Normal messages (status, steps, metrics, progress) use `console.log` prefixed with `▸ ` (e.g. `console.log("▸ Loading model")`)
+  - Caught errors use `console.error` prefixed with `✖ ` (e.g. `console.error("✖", error)`). Reserve `console.error` for errors only — some runtimes render it in red, which looks alarming for ordinary output
+  - Genuine results stay unprefixed so they read apart from the `▸` commentary: stream tokens via `process.stdout.write(token)`, final results via plain `console.log`
+  - Do not use other decorative emojis; only `▸` (info) and `✖` (error)
+  - No shared logging helper — each example stays standalone and copy-pasteable
+- Download progress renders as one in-place line on stderr, not a raw progress-object dump:
+  ```ts
+  onProgress: (p) => {
+    const mb = (n: number) => (n / 1e6).toFixed(1);
+    const line = `▸ Downloading ${p.percentage.toFixed(0)}% (${mb(p.downloaded)}/${mb(p.total)} MB)`;
+    process.stderr.write(process.stderr.isTTY ? `\r${line}` : `${line}\n`);
+    if (p.percentage >= 100) process.stderr.write("\n");
+  },
+  ```
 - Exception for continuously running services (providers, seeders, microphone recording):
   - Use `process.stdin.resume()` to keep running
-  - Include SIGINT handler for graceful shutdown: `process.on("SIGINT", () => { console.log("\n🛑 Service stopped"); process.exit(0); })`
+  - Include SIGINT handler for graceful shutdown: `process.on("SIGINT", () => { console.log("\n▸ Service stopped"); process.exit(0); })`
 

.github/CODEOWNERS

@@ -1 +1 @@
-* @tetherto/qvac-internal-dev @tetherto/qvac-internal-merge
+* @tetherto/qvac-internal-merge @tetherto/qvac-internal-mgmt

.github/actions/verify-changelog-notes/action.yml

@@ -0,0 +1,49 @@
+name: Verify Changelog Notes
+description: Verify a CHANGELOG contains a non-empty "## [version]" section and extract its body
+inputs:
+  changelog-path:
+    required: true
+    description: Path to the CHANGELOG.md file to inspect
+  version:
+    required: true
+    description: Version to look for (x.y.z)
+outputs:
+  release-notes-path:
+    description: Path to a file containing the extracted release-notes body
+    value: ${{ steps.extract.outputs.release_notes_path }}
+runs:
+  using: composite
+  steps:
+    - id: extract
+      shell: bash
+      env:
+        CHANGELOG_PATH: ${{ inputs.changelog-path }}
+        VERSION: ${{ inputs.version }}
+      run: |
+        set -euo pipefail
+        notes="${RUNNER_TEMP}/release-notes-v${VERSION}.md"
+
+        if [ ! -s "${CHANGELOG_PATH}" ]; then
+          echo "::error::Missing or empty changelog: ${CHANGELOG_PATH}"
+          exit 1
+        fi
+
+        start_line=$(awk -v version="${VERSION}" '$0 ~ "^## \\[" version "\\]" { print NR; exit }' "${CHANGELOG_PATH}")
+        if [ -z "${start_line}" ]; then
+          echo "::error::No CHANGELOG heading '## [${VERSION}]' in ${CHANGELOG_PATH}"
+          exit 1
+        fi
+
+        end_line=$(awk -v start="${start_line}" 'NR > start && /^## \[/ { print NR - 1; found=1; exit } END { if (!found) print NR }' "${CHANGELOG_PATH}")
+        if [ -z "${end_line}" ] || [ "${end_line}" -lt "${start_line}" ]; then
+          echo "::error::Invalid changelog section bounds for version ${VERSION}"
+          exit 1
+        fi
+
+        sed -n "$((start_line + 1)),${end_line}p" "${CHANGELOG_PATH}" > "${notes}"
+        if ! awk 'BEGIN { c=0 } /[^[:space:]]/ { c=1 } END { exit c ? 0 : 1 }' "${notes}"; then
+          echo "::error::Changelog section for version ${VERSION} is empty"
+          exit 1
+        fi
+
+        echo "release_notes_path=${notes}" >> "${GITHUB_OUTPUT}"