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

---
schema_version: 1
kind: module_contract
module: src/rttm
level: subsystem
layer: io
purpose: >
  Owns RTTM (Rich Transcription Time Marked) file parsing, grouping, and
  writing. Does NOT own audio I/O (wav.rs) or DER computation (der.rs).
status: stable
owners:
  - polyvoice-core
workcell:
  type: leaf
  parent: ""
  children: []
  owns_paths:
    - src/rttm/
  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: RttmSegment
    kind: struct
    visibility: public
    contract: >
      Single RTTM line parsed into typed fields.
    proof:
      kind: unit-test
      target: src/rttm::mod::tests
      command: cargo test --lib rttm
  - name: RttmError
    kind: enum
    visibility: public
    contract: >
      Error type for RTTM parse/write failures.
    proof:
      kind: unit-test
      target: src/rttm::mod::tests
      command: cargo test --lib rttm
  - name: parse_rttm
    kind: function
    visibility: public
    contract: >
      Parses RTTM lines from a BufRead into RttmSegment vector.
    proof:
      kind: unit-test
      target: src/rttm::mod::tests
      command: cargo test --lib rttm
  - name: parse_rttm_file
    kind: function
    visibility: public
    contract: >
      Convenience: parse RTTM from file path.
    proof:
      kind: unit-test
      target: src/rttm::mod::tests
      command: cargo test --lib rttm
  - name: group_by_file
    kind: function
    visibility: public
    contract: >
      Groups RTTM segments by file identifier.
    proof:
      kind: unit-test
      target: src/rttm::mod::tests
      command: cargo test --lib rttm
  - name: to_speaker_turns
    kind: function
    visibility: public
    contract: >
      Converts RttmSegment vector into polyvoice SpeakerTurns + ID mapping.
    proof:
      kind: unit-test
      target: src/rttm::mod::tests
      command: cargo test --lib rttm
  - name: write_rttm
    kind: function
    visibility: public
    contract: >
      Writes SpeakerTurns as RTTM lines to a Write sink.
    proof:
      kind: unit-test
      target: src/rttm::mod::tests
      command: cargo test --lib rttm
dependencies:
  internal:
    - module: types
      scope: data-shape
      reason: SpeakerId, SpeakerTurn, TimeRange.
  external: []
consumers:
  - path: tests/der_regression_test.rs
    uses:
      - parse_rttm_file
      - group_by_file
      - to_speaker_turns
  - path: tests/der_ami_baseline_test.rs
    uses:
      - parse_rttm_file
      - group_by_file
      - to_speaker_turns
  - path: tests/e2e_smoke_test.rs
    uses:
      - parse_rttm_file
      - to_speaker_turns
      - write_rttm
invariants:
  - id: roundtrip
    rule: write_rttm ∘ parse_rttm preserves segments (within formatting).
    proof:
      kind: unit-test
      target: src/rttm::mod::tests
      command: cargo test --lib rttm
verification:
  pre_change:
    - cargo test --lib rttm
  full:
    - cargo test --lib rttm
    - cargo clippy --all-targets --all-features -- -D warnings
agent_policy:
  allowed_mutations:
    - Adding RTTM variant support.
    - Tuning parse strictness.
  forbidden_mutations:
    - Changing RttmSegment field types without migration lease.
  escalation:
    - Changes to RTTM parse/write format semantics.
---

# src/rttm

RTTM file parsing, grouping, and writing.