phostt 0.4.2__tar.gz

phostt-0.4.2/.cargo/audit.toml

@@ -0,0 +1,4 @@
+[advisories]
+# (no ignores — RUSTSEC-2021-0073 was retired when we migrated the ONNX
+# protobuf pipeline from `onnx-pb 0.1.4 + prost 0.6` to vendored
+# `proto/onnx.proto` + `prost 0.13` via `build.rs`. See `src/onnx_proto.rs`.)

phostt-0.4.2/.cargo/config.toml

@@ -0,0 +1,17 @@
+# Android NDK linker configuration for cargo-ndk builds.
+#
+# Adjust the API level (35) to match your installed NDK version.
+# Common values: 28 (Android 9), 30 (Android 11), 33 (Android 13), 35 (Android 15).
+# The NDK toolchain binaries live inside $NDK_HOME/toolchains/llvm/prebuilt/<host>/bin/.
+
+[target.aarch64-linux-android]
+linker = "aarch64-linux-android35-clang"
+
+[target.armv7-linux-androideabi]
+linker = "armv7a-linux-androideabi35-clang"
+
+[target.x86_64-linux-android]
+linker = "x86_64-linux-android35-clang"
+
+[target.i686-linux-android]
+linker = "i686-linux-android35-clang"

phostt-0.4.2/.dockerignore

@@ -0,0 +1,34 @@
+# Keep the build context small: only files the Dockerfile actually COPYs
+# should reach the daemon. Everything else here either bloats the upload
+# or is a source of unnecessary cache invalidations on edits.
+
+# Build artefacts
+target/
+*.tar.gz
+
+# IDE / editor / OS noise
+.git/
+.github/
+.idea/
+.vscode/
+.DS_Store
+
+# OMC workspace state
+.omc/
+.omx/
+.claude/
+
+# Tests never compiled in --release
+tests/
+benches/
+missions/
+
+# Docs & specs
+docs/
+specs/
+CHANGELOG.md
+CONTRIBUTING.md
+README.md
+README_RU.md
+CLAUDE.md
+AGENTS.md

phostt-0.4.2/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,88 @@
+name: Bug Report
+description: File a bug report to help improve phostt.
+labels: ["bug", "triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report.
+        Please check the [Troubleshooting section of the README](https://github.com/ekhodzitsky/phostt#troubleshooting) first.
+
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      description: What version of phostt are you running?
+      placeholder: "e.g., 0.4.1"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: platform
+    attributes:
+      label: Platform
+      description: What platform are you running on?
+      options:
+        - macOS (Apple Silicon)
+        - macOS (Intel)
+        - Linux (x86_64)
+        - Linux (ARM64)
+        - Android
+        - Windows
+        - Other
+    validations:
+      required: true
+
+  - type: dropdown
+    id: backend
+    attributes:
+      label: Backend
+      description: Which inference backend are you using?
+      options:
+        - CPU (default)
+        - CoreML
+        - CUDA
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug description
+      description: Describe the bug clearly and concisely.
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to reproduce
+      description: Provide a minimal set of steps that consistently reproduces the issue.
+      placeholder: |
+        1. Run `phostt serve ...`
+        2. Send request `curl ...`
+        3. Observe error ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      description: What did you expect to happen?
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs / Output
+      description: Paste relevant log output or error messages (redact sensitive info).
+      render: text
+
+  - type: textarea
+    id: extra
+    attributes:
+      label: Additional context
+      description: Anything else that might help diagnose the issue (audio file format, model source, etc.).

phostt-0.4.2/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Question or Discussion
+    url: https://github.com/ekhodzitsky/phostt/discussions
+    about: Please use GitHub Discussions for questions, usage help, or general conversation.

phostt-0.4.2/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,36 @@
+name: Feature Request
+description: Suggest an idea for phostt.
+labels: ["enhancement", "triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for sharing your idea. Please check the [Roadmap](https://github.com/ekhodzitsky/phostt#roadmap) first to see if it is already planned.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem / Motivation
+      description: What problem are you trying to solve? What is missing?
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: Describe the feature or change you would like to see.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Have you considered other approaches or workarounds?
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context
+      description: Any other context, mockups, or references.

phostt-0.4.2/.github/dependabot.yml

@@ -0,0 +1,59 @@
+# SUS-04: weekly Dependabot scan. We pin Rust deps in `Cargo.lock` and
+# several direct deps (`ort = "2.0.0-rc.12"`, `prost = "0.13"`, …) that
+# would otherwise drift silently — Dependabot keeps the supply chain
+# honest by surfacing new RUSTSEC advisories and minor-version bumps as
+# PRs the maintainer can triage on a predictable cadence.
+
+version: 2
+updates:
+  - package-ecosystem: cargo
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+      time: '05:00'
+      timezone: Europe/Moscow
+    open-pull-requests-limit: 5
+    labels:
+      - dependencies
+      - rust
+    commit-message:
+      prefix: deps
+      include: scope
+    groups:
+      # Group tokio ecosystem bumps together so we don't merge tokio
+      # 1.49 while tokio-util still expects 1.48 — they release close
+      # enough that grouping cuts noise without hiding real churn.
+      tokio-ecosystem:
+        patterns:
+          - 'tokio'
+          - 'tokio-*'
+      # axum + tower + hyper move together for the same reason.
+      axum-ecosystem:
+        patterns:
+          - 'axum'
+          - 'axum-*'
+          - 'tower'
+          - 'tower-*'
+          - 'hyper'
+          - 'hyper-*'
+      # symphonia-* releases are always co-ordinated (bundle versions).
+      symphonia:
+        patterns:
+          - 'symphonia'
+          - 'symphonia-*'
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+      time: '05:00'
+      timezone: Europe/Moscow
+    open-pull-requests-limit: 3
+    labels:
+      - dependencies
+      - github-actions
+    commit-message:
+      prefix: ci
+      include: scope

phostt-0.4.2/.github/workflows/benchmark.yml

@@ -0,0 +1,86 @@
+name: Benchmark
+
+on:
+  push:
+    branches: [master]
+  schedule:
+    # Run every Sunday at 03:00 UTC
+    - cron: '0 3 * * 0'
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  benchmark-macos:
+    runs-on: macos-14
+    name: Benchmark (macOS)
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - uses: actions/cache@v5
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+
+      - name: Cache model
+        id: cache-model
+        uses: actions/cache@v5
+        with:
+          path: ~/.phostt/models
+          key: phostt-model-v3-onnx-${{ hashFiles('src/model/mod.rs') }}
+
+      - name: Download model
+        if: steps.cache-model.outputs.cache-hit != 'true'
+        run: cargo run --release -- download
+
+      - name: Run CPU benchmark
+        id: cpu
+        run: |
+          /usr/bin/time -l cargo test --release --test benchmark_report -- --ignored --nocapture 2>&1 | tee /tmp/cpu_benchmark.txt
+
+      - name: Run CoreML benchmark
+        id: coreml
+        run: |
+          /usr/bin/time -l cargo test --release --test benchmark_report --features coreml -- --ignored --nocapture 2>&1 | tee /tmp/coreml_benchmark.txt
+
+      - name: Parse results and update BENCHMARKS.md
+        run: |
+          COMMIT=$(git rev-parse --short HEAD)
+          DATE=$(date -u +%Y-%m-%d)
+
+          CPU_LATENCY=$(grep "Mean latency" /tmp/cpu_benchmark.txt | sed 's/.*| \([0-9.]*\) ms.*/\1/')
+          CPU_RTF=$(grep "RTF" /tmp/cpu_benchmark.txt | sed 's/.*| \([0-9.]*\)×.*/\1/')
+          CPU_RSS=$(grep "maximum resident set size" /tmp/cpu_benchmark.txt | awk '{print $1}')
+          CPU_RSS_MB=$(echo "scale=1; $CPU_RSS / 1024 / 1024" | bc)
+
+          COREML_LATENCY=$(grep "Mean latency" /tmp/coreml_benchmark.txt | sed 's/.*| \([0-9.]*\) ms.*/\1/')
+          COREML_RTF=$(grep "RTF" /tmp/coreml_benchmark.txt | sed 's/.*| \([0-9.]*\)×.*/\1/')
+          COREML_RSS=$(grep "maximum resident set size" /tmp/coreml_benchmark.txt | awk '{print $1}')
+          COREML_RSS_MB=$(echo "scale=1; $COREML_RSS / 1024 / 1024" | bc)
+
+          {
+            echo ""
+            echo "## ${DATE} (commit ${COMMIT})"
+            echo ""
+            echo "### macOS-14 (Apple Silicon)"
+            echo ""
+            echo "| Backend | Mean Latency | RTF | Peak RSS |"
+            echo "|---|---|---|---|"
+            echo "| CPU | ${CPU_LATENCY} ms | ${CPU_RTF} | ${CPU_RSS_MB} MB |"
+            echo "| CoreML | ${COREML_LATENCY} ms | ${COREML_RTF} | ${COREML_RSS_MB} MB |"
+          } >> BENCHMARKS.md
+
+      - name: Commit benchmark results
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "benchmark: auto-update BENCHMARKS.md [skip ci]"
+          file_pattern: BENCHMARKS.md

phostt-0.4.2/.github/workflows/check-ort-stable.yml

@@ -0,0 +1,65 @@
+name: Check ort stable release
+
+on:
+  schedule:
+    # Every Monday at 09:00 UTC
+    - cron: '0 9 * * 1'
+  workflow_dispatch:
+
+permissions:
+  issues: write
+
+jobs:
+  check-ort:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Check crates.io for ort stable
+        id: check
+        run: |
+          LATEST=$(curl -s https://crates.io/api/v1/crates/ort | jq -r '.crate.max_version')
+          echo "latest=$LATEST" >> "$GITHUB_OUTPUT"
+
+          CURRENT=$(grep -E '^ort\s*=' Cargo.toml | head -1 | sed 's/.*"\(.*\)".*/\1/')
+          echo "current=$CURRENT" >> "$GITHUB_OUTPUT"
+
+          # Detect if latest is a stable 2.0.0+ release (no rc/beta/alpha/pre)
+          if echo "$LATEST" | grep -qiE '(rc|beta|alpha|pre|dev)'; then
+            echo "stable=false" >> "$GITHUB_OUTPUT"
+            echo "ort $LATEST is still pre-release (current: $CURRENT)"
+          else
+            echo "stable=true" >> "$GITHUB_OUTPUT"
+            echo "ort $LATEST looks stable (current: $CURRENT)"
+          fi
+
+      - name: Open issue if stable ort is available
+        if: steps.check.outputs.stable == 'true' && steps.check.outputs.latest != steps.check.outputs.current
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          LATEST="${{ steps.check.outputs.latest }}"
+          CURRENT="${{ steps.check.outputs.current }}"
+
+          # Check if an open issue already exists
+          EXISTING=$(gh issue list --repo "${{ github.repository }}" \
+            --search "ort stable $LATEST" --state open --json number | jq length)
+
+          if [ "$EXISTING" -gt 0 ]; then
+            echo "Issue already exists for ort $LATEST"
+            exit 0
+          fi
+
+          gh issue create \
+            --repo "${{ github.repository }}" \
+            --title "deps: ort $LATEST stable is available (current: $CURRENT)" \
+            --body "crates.io now has \`ort $LATEST\` which appears to be a stable (non-pre-release) version.
+
+Current pin: \`$CURRENT\`
+
+**Migration notes:**
+- Check [pykeio/ort CHANGELOG](https://github.com/pykeio/ort/releases/tag/v$LATEST) for breaking changes.
+- Update \`Cargo.toml\` and run full test suite (unit + E2E + benchmark).
+- Verify CoreML and CUDA feature builds still pass.
+
+This issue was auto-generated by the [check-ort-stable workflow](.github/workflows/check-ort-stable.yml)."

phostt-0.4.2/.github/workflows/ci.yml

@@ -0,0 +1,218 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  fmt:
+    runs-on: ubuntu-latest
+    name: Format
+    steps:
+      - uses: actions/checkout@v6
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt
+      - run: cargo fmt --check
+
+  clippy:
+    runs-on: ubuntu-latest
+    name: Clippy
+    steps:
+      - uses: actions/checkout@v6
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy
+      - uses: actions/cache@v5
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+      - run: cargo clippy -- -D warnings -A dead_code
+
+  unit-tests:
+    runs-on: ubuntu-latest
+    name: Unit Tests
+    steps:
+      - uses: actions/checkout@v6
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: actions/cache@v5
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+      - run: cargo test
+
+  build-coreml:
+    runs-on: macos-14
+    name: Build (CoreML)
+    steps:
+      - uses: actions/checkout@v6
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: actions/cache@v5
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+      - run: cargo build --release --features coreml
+
+  build-cuda:
+    runs-on: ubuntu-latest
+    name: Build (CUDA)
+    steps:
+      - uses: actions/checkout@v6
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: actions/cache@v5
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+      - run: cargo build --release --features cuda
+
+  build-diarization:
+    runs-on: ubuntu-latest
+    name: Build (Diarization)
+    steps:
+      - uses: actions/checkout@v6
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: actions/cache@v5
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+      - run: cargo build --release --features diarization
+
+  build-arm-linux:
+    runs-on: ubuntu-latest
+    name: Build (ARM Linux)
+    steps:
+      - uses: actions/checkout@v6
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: aarch64-unknown-linux-gnu
+      - uses: actions/cache@v5
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+      - name: Install cross-compiler
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y gcc-aarch64-linux-gnu g++-aarch64-linux-gnu libc6-dev-arm64-cross
+          echo "CARGO_TARGET_AARCH64_UNKNOWN_LINUX_GNU_LINKER=aarch64-linux-gnu-gcc" >> "$GITHUB_ENV"
+          echo "CARGO_TARGET_AARCH64_UNKNOWN_LINUX_GNU_AR=aarch64-linux-gnu-ar" >> "$GITHUB_ENV"
+      - run: cargo check --target aarch64-unknown-linux-gnu --release
+
+  e2e-tests:
+    # Only run on main push — PRs get fast feedback from unit tests + clippy
+    if: github.ref == 'refs/heads/master' && github.event_name == 'push'
+    runs-on: ubuntu-latest
+    name: E2E Tests
+    steps:
+      - uses: actions/checkout@v6
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: actions/cache@v5
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+
+      - name: Cache model
+        id: cache-model
+        uses: actions/cache@v5
+        with:
+          path: ~/.phostt/models
+          key: phostt-model-v3-onnx-${{ hashFiles('src/model/mod.rs') }}
+
+      - name: Download model
+        if: steps.cache-model.outputs.cache-hit != 'true'
+        run: cargo run -- download
+
+      - name: Run e2e tests
+        run: cargo test --test e2e_rest --test e2e_ws --test e2e_errors --test e2e_shutdown -- --ignored --test-threads=1
+        timeout-minutes: 30
+
+      - name: Run quality tests (bundled Vietnamese WAVs)
+        run: cargo test --test wer -- --ignored
+        timeout-minutes: 10
+
+      - name: Run load tests
+        run: cargo test --test load_test -- --ignored --test-threads=1
+        timeout-minutes: 10
+
+  e2e-pr:
+    if: github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+    name: E2E Tests (PR)
+    steps:
+      - uses: actions/checkout@v6
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: actions/cache@v5
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+
+      - name: Cache model
+        id: cache-model
+        uses: actions/cache@v5
+        with:
+          path: ~/.phostt/models
+          key: phostt-model-v3-onnx-${{ hashFiles('src/model/mod.rs') }}
+
+      - name: Download model
+        if: steps.cache-model.outputs.cache-hit != 'true'
+        run: cargo run -- download
+
+      - name: Run e2e tests
+        run: cargo test --test e2e_rest --test e2e_ws --test e2e_errors --test e2e_shutdown -- --ignored --test-threads=1
+        timeout-minutes: 30
+
+      - name: Run quality tests (bundled Vietnamese WAVs)
+        run: cargo test --test wer -- --ignored
+        timeout-minutes: 10
+
+  audit:
+    runs-on: ubuntu-latest
+    name: Security Audit
+    steps:
+      - uses: actions/checkout@v6
+      # `rustsec/audit-check` ships a prebuilt cargo-audit, saving the ~90 s
+      # `cargo install --locked` rebuild on every PR run.
+      - uses: rustsec/audit-check@v2
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+  deny:
+    runs-on: ubuntu-latest
+    name: Cargo Deny
+    steps:
+      - uses: actions/checkout@v6
+      - uses: EmbarkStudios/cargo-deny-action@v2
+        with:
+          # Default `check` covers licenses + advisories + bans + sources.
+          # An earlier attempt passed them as `arguments: licenses advisories …`,
+          # but the stable-musl `cargo-deny` refused the trailing positional
+          # args as subcommands (`unrecognized subcommand 'licenses'`).
+          command: check

phostt-0.4.2/.github/workflows/docs.yml

@@ -0,0 +1,22 @@
+name: Docs
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v6
+      - uses: dtolnay/rust-toolchain@stable
+      - run: cargo doc --no-deps --document-private-items
+      - name: Add index redirect
+        run: echo '<meta http-equiv="refresh" content="0;url=phostt/index.html">' > target/doc/index.html
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./target/doc