Bugfix in the seriatim input adapter

docs/integrations/seriatim.md

@@ -1,4 +1,4 @@
-# Seriatim Minimal Transcript JSON
+# Seriatim Transcript JSON
 
 This document is the external input contract for the implemented `seriatim`
 input adapter.
@@ -8,7 +8,7 @@ input adapter.
 - Module key: `seriatim`
 - Document kind: `transcript`
 - Unit kind: `transcript_segment`
-- Source format: `application/vnd.seriatim.minimal+json`
+- Source format: `application/vnd.seriatim+json`
 
 The adapter parses raw Seriatim JSON into a generic source document. It owns
 transcript-specific JSON parsing and metadata mapping; core source and pipeline
@@ -17,7 +17,8 @@ code stay source-format agnostic.
 ## Accepted Shape
 
 The input must be one JSON object with top-level `metadata` and `segments`
-fields:
+fields. This covers the maintained minimal fixture and Seriatim intermediate
+output that provides the same required segment fields.
 
 ```json
 {
@@ -40,7 +41,8 @@ fields:
 The maintained example is
 [examples/seriatim-minimal-transcript.json](../../examples/seriatim-minimal-transcript.json).
 
-Top-level metadata entries are preserved. Other segment fields are ignored.
+Top-level metadata entries are preserved. Other segment fields, such as
+`categories`, are ignored.
 
 Multiple top-level JSON values are rejected.
 
@@ -54,7 +56,8 @@ The adapter rejects:
 - missing, null, or non-object `metadata`;
 - missing, null, non-array, or empty `segments`;
 - segment values that are not objects;
-- non-string `id`, `speaker`, or `text`;
+- segment `id` values that are neither strings nor numbers;
+- non-string `speaker` or `text`;
 - empty segment IDs;
 - segment IDs with leading or trailing whitespace;
 - duplicate segment IDs;
@@ -72,7 +75,7 @@ The adapter maps input to `SourceDocument`:
 
 - `metadata` becomes `SourceDocument.Metadata`;
 - `SourceDocument.Kind` is `transcript`;
-- `SourceDocument.Format` is `application/vnd.seriatim.minimal+json`;
+- `SourceDocument.Format` is `application/vnd.seriatim+json`;
 - `SourceDocument.Digest` is `sha256:<hex>` of the exact raw input bytes.
 
 `SourceDocument.ID` is selected in this order:
@@ -84,7 +87,8 @@ The adapter maps input to `SourceDocument`:
 
 Each segment becomes one `SourceUnit`:
 
-- `segment.id` becomes `SourceUnit.ID`;
+- `segment.id` becomes `SourceUnit.ID`; numeric IDs are converted to their JSON
+  number text, so `1` becomes `"1"`;
 - `segment.text` becomes `SourceUnit.Text`;
 - `SourceUnit.Kind` is `transcript_segment`;
 - `speaker`, `start`, and `end` are stored in source-unit metadata.
@@ -110,4 +114,7 @@ The module declares these provided capabilities:
 
 ## Compatibility Limit
 
-This contract covers only the minimal transcript JSON shape described here.
+This contract covers only Seriatim transcript JSON with the top-level
+`metadata` object and `segments` array described here. Broader Seriatim output
+schemas are compatible only when they provide these required fields with the
+accepted types.