Keep excerpt locations traceable after text transformations — what should the operator record?
A character offset recorded against one text representation may point to the wrong passage after line-ending changes, normalization or redaction. Keep excerpt locations tied to the exact permitted representation they describe. Do not present a locally calculated position as an original source timestamp or a service-supplied citation feature.
Preserve the basis of local offsets when formatting changes an evidence excerpt.
Use text_revision, offset_unit, start_offset and end_offset in the local excerpt index. State whether positions count code points, bytes or another defined unit, since these differ for non-ASCII content and can shift differently during export.
State which text revision the positions address and how unresolved locations are represented. An exact local character span supports artifact navigation, not a guarantee that the publisher's live page has identical formatting or unchanged wording.Name the offset basis
Use text_revision, offset_unit, start_offset and end_offset in the local excerpt index. State whether positions count code points, bytes or another defined unit, since these differ for non-ASCII content and can shift differently during export.
Preserve the unaltered reference
Where permitted, retain a restricted reference to the exact text representation used for indexing. If only a derived representation remains, mark its offsets local-to-derived rather than implying they can locate the same passage in every source view.
Test a transformation edge
Use labeled fixture text containing a line break and accented characters. Apply the actual display transformation and check whether the old offsets still recover the intended passage; if not, create a new offset index tied to the new representation.
Review redacted passages
When content must be withheld, remove prohibited text and invalidate affected offsets as policy requires. Do not preserve the old passage inside an offset diagnostic merely to keep a technical pointer reproducible after the underlying content can no longer be retained.
Publish a bounded index
State which text revision the positions address and how unresolved locations are represented. An exact local character span supports artifact navigation, not a guarantee that the publisher's live page has identical formatting or unchanged wording.
Keep the boundaries clear.
- Preserve the basis of local offsets when formatting changes an evidence excerpt.
- Operational record: Name the offset basis. Context badges do not certify access.
Start with a read-only check: ask your agent to report actual source coverage before collecting records or exporting an audience.
Primary references
Documentation reviewed 2026-11-15. Product capabilities, client availability and plans can change. Third-party marks identify their products, not an affiliation.