orchestrata_ultimate.core.tracing.traceability

Reference › orchestrata_ultimate › core › tracing › traceability

A superseded shim. The traceability consolidation ruling (D2 of plans/decisions-2026-07-06.md) moved the real implementation to core.traceability, which itself takes the @traces decorator from the layer-0 base.traces. This module only re-exports TraceInfo, ValidationReport, generate_rtm, generate_rtm_markdown, traces and validate_traces from there. It was not deleted because production modules still import it (the CXP Prolog bridge, the session graph-sync modules and the scanner among them); the module's note is to repoint those importers and delete it when the count reaches zero.

At a glance


Source	`src/orchestrata_ultimate/core/tracing/traceability.py`
Lines of code	36
Classes	0
Functions	0
Imports (internal)	`orchestrata_ultimate.core.traceability`
Imported by	`orchestrata_ultimate.core.tracing.scanner`, `orchestrata_ultimate.cxp.prolog_bridge`, `orchestrata_ultimate.session.kg_sync`, `orchestrata_ultimate.session.kg_sync._base`, `orchestrata_ultimate.session.kg_sync._stage_code`, `orchestrata_ultimate.session.kg_sync._stage_session`, `orchestrata_ultimate.session.kg_sync._stage_specs_traces`, `scripts.sync_traces_to_graph`
Tests that import it	`tests/core/test_tracing.py`, `tests/knowledge_graph/test_code_intelligence.py`, `tests/knowledge_graph/test_code_intelligence_coverage.py`, `tests/knowledge_graph/test_code_intelligence_graph.py`, `tests/knowledge_graph/test_graph_context_injection.py`, `tests/knowledge_graph/test_kg_sync.py`, `tests/knowledge_graph/test_kg_sync_edges.py`, `tests/knowledge_graph/test_schema_completeness.py`, `tests/postman/test_cxp_redis_delivery.py`, `tests/session/test_session_archive.py`, `tests/session/test_session_cli.py`, `tests/session/test_session_integrity.py`, `tests/test_core.py`

Class diagram

No classes; see Functions.

Dependency diagram

API

No public API: the module defines no classes, functions or constants.

Source

Permalink: https://gitlab.com/MSamy/orchestrata-ultimate-architecture/-/blob/a4cbc2bdf/src/orchestrata_ultimate/core/tracing/traceability.py

"""Requirement traceability annotations -- SUPERSEDED, thin shim.

This module is superseded by ``orchestrata_ultimate.core.traceability``
(see D2 of plans/decisions-2026-07-06.md, the traceability consolidation
ruling). It previously carried its own copy of the @traces decorator, the
RTM generator, and the validator -- including a stray corrupted header in
``generate_rtm_markdown`` -- diverging from the canonical implementations.

All public names are now re-exported from ``core.traceability`` (which
itself re-exports the @traces decorator from the layer-0 canonical
``core.base.traces``). Kept in place, rather than deleted, because more
production modules than originally scoped still import from this path
(see the W3.2 refactor report); repoint importers and delete once the
count reaches zero.

Usage:
    from orchestrata_ultimate.core.traceability import traces
"""

from orchestrata_ultimate.core.traceability import (
    TraceInfo,
    ValidationReport,
    generate_rtm,
    generate_rtm_markdown,
    traces,
    validate_traces,
)

__all__ = [
    "TraceInfo",
    "ValidationReport",
    "generate_rtm",
    "generate_rtm_markdown",
    "traces",
    "validate_traces",
]