__init__.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# oc_chat/registry/roadmap/__init__.py
 
# OCT-LINT: disable=tests_exist reason="Covered by oc_chat/tests/registry/roadmap/test_*.py"
"""
Registry-backed ROADMAP parser, ingest, audit, and operations.
 
Purpose
-------
Expose the public roadmap registry package surface.
 
Responsibilities
----------------
- Re-export parser record types and parse helpers.
- Re-export roadmap mutating operation helpers.
- Keep package import side effects limited to diagnostics module-load logging.
 
Diagnostics
-----------
Domain: OC_CHAT.MAIN
Levels:
    L2 - package import lifecycle
    L3 - public surface changes
    L4 - import dependency tracing
 
Contracts
---------
- This module performs no filesystem or database writes.
- SQL ownership remains inside the SQLite backend.
 
Dependencies
------------
- oc_chat.registry.roadmap.parser (re-exported parser record types and parse helpers)
- oc_chat.registry.roadmap.operations (re-exported roadmap operation helpers)
- oc_diagnostics (structured debug logging via _dbg)
"""
from __future__ import annotations
 
from oc_diagnostics import _dbg
 
from oc_chat.registry.roadmap.operations import (
    roadmap_item_add_dependency,
    roadmap_item_create,
    roadmap_item_set_status,
    roadmap_phase_complete,
    roadmap_plan_link_create,
    roadmap_section_upsert,
    roadmap_version_bump,
)
from oc_chat.registry.roadmap.parser import (
    ParsedDependency,
    ParsedItem,
    ParsedPhase,
    ParsedRoadmap,
    ParsedRenderSection,
    ParsedTrack,
    RoadmapParseError,
    canonical_record_hash,
    parse_roadmap_file,
)
 
_dbg("OC_CHAT.MAIN", "module", "loaded", 4)
 
__all__ = [
    "ParsedDependency",
    "ParsedItem",
    "ParsedPhase",
    "ParsedRoadmap",
    "ParsedRenderSection",
    "ParsedTrack",
    "RoadmapParseError",
    "canonical_record_hash",
    "parse_roadmap_file",
    "roadmap_item_add_dependency",
    "roadmap_item_create",
    "roadmap_item_set_status",
    "roadmap_phase_complete",
    "roadmap_plan_link_create",
    "roadmap_section_upsert",
    "roadmap_version_bump",
]