Threads

Overview

Domain page auto-seeded by wiki bootstrap for new source lane.

Covered files

• apps/portal/templates/threads/threads.html
• apps/portal/tests/test_threads_transport_api.py
• apps/portal/threads/README.md
• apps/portal/threads/__init__.py
• apps/portal/threads/threads_transport.py

File map

threads.html

• Path: apps/portal/templates/threads/threads.html
• What: Template for threads UI surface in apps/portal/templates.
• Does: Defines rendered structure, states, and UI hooks consumed by Portal routes.
• Why: Keeps operator-facing behavior predictable and discoverable without digging into route code.

test_threads_transport_api.py

• Path: apps/portal/tests/test_threads_transport_api.py
• What: Tests for Threads transport normalize/history APIs.
• Does: Verifies envelope adaptation, deterministic cursor pagination boundaries, and invalid parameter handling.
• Why: Locks TASK-130/TASK-131 initial backend transport contract for Threads/Tzen parity.

README.md

• Path: apps/portal/threads/README.md
• What: apps/portal/threads/ contains threads runtime services and adapters. This boundary currently has 3 direct file(s) and 0 direct subfolder(s).
• Does: It implements runtime-facing product behavior and integration wiring (dominant direct file kinds: .py:2, .md:1).
• Why: This is where user-visible behavior is delivered, so clear ownership is critical for reliable iteration.

__init__.py

• Path: apps/portal/threads/__init__.py
• What: init module for apps/portal/threads.
• Does: Implements module routines used by this runtime surface.
• Why: Keeps behavior boundaries explicit so wiki maps stay useful without reading full files.

threads_transport.py

• Path: apps/portal/threads/threads_transport.py
• What: Transport adapter/helpers for Threads <-> Tzen message parity.
• Does: Normalizes heterogeneous message payloads into a stable envelope and provides deterministic cursor pagination helpers.
• Why: Keeps thread transport contract explicit and testable before wiring live DB/event stream backends.

Test coverage

• (no explicit Tests headers found)