TranscriptX terminology index (non-authoritative)

This document is an index of terms only. It aggregates terminology from the authoritative CONTRACT documents and points back to them.

  • It must not introduce new semantics or rules.

  • If any wording here appears to conflict with a CONTRACT document, the CONTRACT document wins.

Where you need the actual definition or invariant, always read the linked CONTRACT section.

Terms and authorities

  • Canonical transcript

    • See storage contract: docs/runtime/STORAGE.md (canonical transcript validation).

    • See ingestion guide (non-authoritative detail): docs/runtime/transcription.md. Host import API: docs/runtime/host-stt.md.

  • Managed transcript

    • See storage contract: docs/runtime/STORAGE.md (managed transcript and metadata layout).

  • Library-valid transcript

    • See storage contract: docs/runtime/STORAGE.md (canonical + sidecars + archival/original linkage).

  • Sidecar

    • See storage contract: docs/runtime/STORAGE.md (metadata mirroring invariant and sidecar paths).

  • Metadata subtree

    • See storage contract: docs/runtime/STORAGE.md (metadata subtree layout and helpers).

  • Staging vs canonical storage

    • See storage contract: docs/runtime/STORAGE.md (imports/ staging semantics and canonical storage model).

  • Run outcome / execution truth

    • See run outcome contract: docs/run_outcome_contract.md.

  • Outputs and run artifacts

    • See output contract: docs/contracts/output-contract-v1.md.

    • Overview ZIP / HTML / EPUB packaging: docs/runtime/export.md (guide; selection-scoped presentation indexes).

  • Public surface / supported surface

    • See public surfaces contract: docs/public_surfaces.md.

    • Viewer Correct mode (behaviour guide): docs/runtime/corrections-viewer.md.

  • Settings / configuration scopes

    • Precedence and config_dir: docs/runtime/STORAGE.md.

    • User guide (Common vs Advanced, Profiles page): docs/runtime/settings.md.

  • Install profile (core | full)

    • Capability / dependency story — not module presets. See docs/runtime/installation-advanced.md and docs/dev/install_profiles_matrix.md.

  • Module / workflow profile

    • Named JSON under {config_dir}/profiles/<target>/. See docs/runtime/settings.md and docs/runtime/STORAGE.md.

  • Analysis UI preset (Quick / Balanced / Thorough)

    • Module-set policies for Run Analysis. See docs/runtime/settings.md.

  • Speaker profile

    • Longitudinal identity / voice store (separate from analysis knobs). See docs/contracts/speaker_profiles_v1.md and docs/contracts/speaker_profiles_voice_v1.md.

  • Auto-name / auto-link

    • Orthogonal ingest knobs that may write speaker-map display names and/or auto_identified profile links after admit. See docs/contracts/speaker_profiles_voice_v1.md. Operator guide: docs/runtime/auto-identify.md.

  • auto_identified

    • link_method (and speaker-map mapping method) for fusion-applied ingest. Trust maps like suggestion_assisted until promote. See docs/contracts/speaker_profiles_voice_v1.md.

  • Speaker-map sidecar

    • Per-transcript display names / ignore lists under transcripts/metadata/speaker_maps/. See docs/runtime/STORAGE.md and docs/contracts/speaker_profiles_v1.md.

  • Library

    • Managed transcript library (transcripts_dir / HOST_TRANSCRIPTS_DIR). See docs/runtime/STORAGE.md.

  • Library archive

    • Optional library_archived flag on the import sidecar: item stays on disk and remains findable, but pickers and default lists omit it. See docs/runtime/STORAGE.md (Library archive). Distinct from archived_original_relpath and from Speakers profile archive.

  • originals/

    • Staging subtree inside the managed library where host STT lands. Gate: admit. See docs/runtime/STORAGE.md, docs/runtime/transcription.md.

  • Import inbox

    • External drop mount (HOST_TRANSCRIPT_INBOX_DIR → /mnt/transcript-inbox) for Import all from folder. Not originals/. See docs/runtime/docker.md.

  • Admit

    • Promote originals/ to a library-valid transcript. See docs/runtime/host-stt.md, docs/runtime/STORAGE.md.

  • Ask

    • Opt-in RAG over one transcript (session_slug + run_id). Default off (TRANSCRIPTX_RAG_ENABLED). Fail closed if scope is missing. Distinct from Custom Questions (llm_custom_qa) as a pipeline module; the Ask page may still run global entries from the same Settings → Questions library (per-speaker library entries stay on Run Analysis).

This index may grow as new terms are introduced in CONTRACT docs, but each term here must always delegate meaning to those documents rather than redefining it.