polyvoice 0.6.0-alpha.6

Speaker diarization library for Rust — online and offline, ONNX-powered, ecosystem-agnostic
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154

---
schema_version: 1
kind: module_contract
module: src/models
level: subsystem
layer: infrastructure
purpose: >
  Owns model registry, manifest parsing, HTTP downloads, SHA-256 verification,
  and minisig signature verification for ONNX model bundles. Does NOT own
  model inference (that lives in onnx, embedder, segmentation).
status: stable
owners:
  - polyvoice-core
workcell:
  type: leaf
  parent: ""
  children: []
  owns_paths:
    - src/models/
  context_budget:
    max_files: 12
    max_source_lines: 1500
    max_contract_lines: 180
    max_readme_lines: 120
    max_todo_lines: 80
authority:
  write_policy: single_active_write_lease
  orchestrator: polyvoice-core
  read_agents: many_allowed
  migration_lease_required:
    - cross-workcell write
    - public surface migration
surface:
  - name: ModelRegistry
    kind: struct
    visibility: public
    contract: >
      Downloads, caches, and verifies ONNX model bundles by profile.
    proof:
      kind: unit-test
      target: src/models::mod::tests
      command: cargo test --lib models --features download
  - name: ProfileModels
    kind: struct
    visibility: public
    contract: >
      Paths to cached embedder, segmenter, and clusterer models for a profile.
    proof:
      kind: unit-test
      target: src/models::mod::tests
      command: cargo test --lib models --features download
  - name: RegistryError
    kind: enum
    visibility: public
    contract: >
      Errors for registry operations (download, verify, manifest parse).
    proof:
      kind: unit-test
      target: src/models::mod::tests
      command: cargo test --lib models --features download
  - name: Manifest
    kind: struct
    visibility: public
    contract: >
      Typed TOML manifest describing available model bundles.
    proof:
      kind: unit-test
      target: src/models::manifest::tests
      command: cargo test --lib models --features download
  - name: DEFAULT_MANIFEST_TOML
    kind: constant
    visibility: public
    contract: >
      Embedded default manifest string.
    proof:
      kind: unit-test
      target: src/models::mod::tests
      command: cargo test --lib models --features download
dependencies:
  internal:
    - module: types
      scope: data-shape
      reason: Profile enum for model profile selection.
  external:
    - name: ureq
      scope: network
      reason: HTTP download of model bundles.
    - name: sha2
      scope: crypto
      reason: SHA-256 verification of downloaded files.
    - name: minisign-verify
      scope: crypto
      reason: Signature verification of model bundles.
    - name: dirs
      scope: filesystem
      reason: Cross-platform cache directory resolution.
    - name: toml
      scope: parsing
      reason: Manifest TOML deserialization.
consumers:
  - path: src/ffi/mod.rs
    uses:
      - ModelRegistry
  - path: src/pipeline/mod.rs
    uses:
      - ModelRegistry
      - ProfileModels
  - path: tests/der_regression_test.rs
    uses:
      - ModelRegistry
  - path: tests/der_ami_baseline_test.rs
    uses:
      - ModelRegistry
  - path: tests/m5_manifest_smoke_test.rs
    uses:
      - ModelRegistry
      - Manifest
invariants:
  - id: verify-sha256
    rule: Downloaded files must match manifest SHA-256 before use.
    proof:
      kind: unit-test
      target: src/models::verify::tests
      command: cargo test --lib models --features download
  - id: verify-signature
    rule: Downloaded files must pass minisig verification before use.
    proof:
      kind: unit-test
      target: src/models::verify::tests
      command: cargo test --lib models --features download
verification:
  pre_change:
    - cargo test --lib models --features download
  full:
    - cargo test --lib models --features download
    - cargo test --test m5_manifest_smoke_test --features download
    - cargo clippy --all-targets --all-features -- -D warnings
agent_policy:
  allowed_mutations:
    - Adding new model entries to manifest.
    - Improving download retry logic.
    - Adding new verification backends.
  forbidden_mutations:
    - Removing SHA-256 or signature verification.
    - Changing ModelRegistry::default() behavior without updating tests.
  escalation:
    - Changes to manifest schema version.
    - Changes to verification requirements (SHA-256, signatures).
    - Adding new external download dependencies.
---

# src/models

Model registry, manifest, download, and verification.