kcode-audio-session-view 0.1.1

Deterministic recording and History-piece views for audio session facades
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

# Audio Session View

`kcode-audio-session-view` 0.1.1 is a deterministic leaf for adapting one
`kcode_audio_ingress::RecordingStatus` and one
`kcode_audio_history_handoff::RecordingProjection` into the established audio
session facade view.

```rust
use kcode_audio_session_view::{RecordingView, render};

let view: RecordingView = render(recording_status, history_projection);
```

## Public boundary

The library exposes one operation:

```rust
pub fn render(
    recording: kcode_audio_ingress::RecordingStatus,
    projection: kcode_audio_history_handoff::RecordingProjection,
) -> RecordingView;
```

`RecordingView` contains the adapted `Recording` and its ordered
`Vec<IngressPiece>`. `Recording`, `SpeakerReview`, and `IngressPiece` preserve
the field sets and `Clone, Debug` derives established by
`kcode-audio-session-ingress` 0.2.3. The operation is infallible and performs no
I/O or mutation. The projection's `recording_id` is not compared because Audio
History Handoff guarantees projection identity and input order.

## Status adaptation

Audio states retain the facade strings:

- queued: `uploaded`;
- processing: `chunking`, `transcribing`, `analyzing_speakers`,
  `training_speakers`, or `reconciling`;
- failed: `failed`;
- completed but awaiting human speaker confirmation: `speaker_review`; and
- other completed recordings without projected pieces: `ready_for_ingress`.

Represented History pieces override those base states. All-complete pieces
produce `complete`; otherwise any `ingress_failed` piece produces
`ingress_failed`; otherwise any `ingress_in_progress` piece produces
`ingressing`; every other represented phase produces `ready_for_ingress`.

Processing progress is serialized into `transcription_status` with the same
best-effort JSON behavior as the facade. Completed-piece counts include only
the exact `complete` phase. `updated_at` remains equal to Audio Ingress
`received_at`.

## Ownership and exclusions

Audio Ingress remains the authority for recording identity, source metadata,
processing progress, speaker correction, and transcript completion. Audio
History Handoff remains the authority for History correlation, projected
piece order, synchronization, retry, and retained lifecycle records.

This leaf owns only deterministic field and status adaptation. It owns no
persistence, AudioIngress or Session History operation, confirmation, retry,
synchronization, provider, credentials, transport, tracing, locking, recovery,
deployment, publication, or state mutation.

Direct tests cover queued, failed, completed, and speaker-review recordings;
History phase priority and completed counts; complete recording and piece field
mapping; and all feasible Audio processing-stage mappings through the published
dependency types.