"""Optionales Submodul: Tagesabschluss-Routine.

Dieses Skeleton zeigt, wie ein erweiterter Tagesabschluss-Modus an den
session-log-Skill angedockt werden kann. Im Bundle ist nur dieser
Beispiel-Stub enthalten — die tatsächliche Logik bleibt benutzerspezifisch
(Daily-Note-Backfill, Dashboard-Refresh, Tracker-Pflege etc.).

Aktivierung:
  1. Datei nach _optional/tagesabschluss.py kopieren (ohne .example).
  2. In skill.config.yaml: features.tagesabschluss_modus: true setzen.
  3. Eigene Logik implementieren — die Funktion run() wird vom Skill
     aufgerufen, sobald der Tagesabschluss-Trigger erkannt wird.
"""

from pathlib import Path


def run(skill_config, *, vault_root: Path) -> int:
    """Wird vom Hauptskript aufgerufen, wenn tagesabschluss_modus aktiv ist.

    Args:
        skill_config: SkillConfig-Instanz aus _lib.config_loader.
        vault_root: Wurzel des Vaults.

    Returns:
        Exit-Code (0 = erfolgreich).
    """
    raise NotImplementedError(
        "tagesabschluss.example.py ist nur ein Skeleton. "
        "Kopiere nach tagesabschluss.py und implementiere deine Logik."
    )
