Lift the format-agnostic pieces from decnet/orchestrator/emailgen/
into the new decnet/realism/ library so file-class content generation
(stage 3 of the realism migration) can reuse them. Email-specific
delivery (RFC 2822 EML, IMAP/POP3 spool, thread chains) stays in
orchestrator/.
Renames (history-preserving git mv):
emailgen/personas.py -> realism/personas.py
emailgen/prompt.py -> realism/prompts/email.py
emailgen/global_pool.py -> realism/personas_pool.py
emailgen/llm/ -> realism/llm/
Env-var clean break (pre-v1, no aliases):
DECNET_EMAILGEN_LLM -> DECNET_REALISM_LLM
DECNET_EMAILGEN_MODEL -> DECNET_REALISM_MODEL
DECNET_EMAILGEN_TIMEOUT -> DECNET_REALISM_TIMEOUT
DECNET_EMAILGEN_PERSONAS -> DECNET_REALISM_PERSONAS
DECNET_EMAILGEN_FAKE_OUTPUT -> DECNET_REALISM_FAKE_OUTPUT
Importers rewritten in: orchestrator/emailgen/scheduler.py,
orchestrator/drivers/email.py, web/router/{emailgen,topology}/
api_personas.py, cli/emailgen.py. Tests for moved modules relocated
to tests/realism/; tests for stay-put modules updated in place.
API URL `/api/v1/emailgen/personas` and CLI `decnet emailgen
import-personas` keep their public names until the service-collapse
commit (stage 5).
34 lines
1.3 KiB
Python
34 lines
1.3 KiB
Python
"""Emailgen — second orchestrator worker.
|
|
|
|
Generates fake corporate emails (multi-language, threaded, persona-driven)
|
|
and drops them into mail-decky maildirs so attackers landing on
|
|
IMAP/POP3 honeypots find believable mailboxes instead of empty inboxes.
|
|
|
|
The module is intentionally a sibling of :mod:`decnet.orchestrator` (not
|
|
a flag on it) — separate worker, separate CLI command
|
|
(``decnet emailgen``), separate systemd-supervised lifecycle. Shares the
|
|
heartbeat / control-listener scaffolding via :mod:`decnet.bus.publish`.
|
|
|
|
Lazy worker re-export: :func:`emailgen_worker` is loaded on first
|
|
attribute access so that submodules can import package-level names
|
|
(``decnet.orchestrator.emailgen.events``) without triggering an eager
|
|
load of the worker — and through it, the email driver, which imports
|
|
back into this package. Without lazy loading the package + driver +
|
|
worker form a cycle.
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
from typing import TYPE_CHECKING, Any
|
|
|
|
if TYPE_CHECKING: # pragma: no cover - typing only
|
|
from decnet.orchestrator.emailgen.worker import emailgen_worker # noqa: F401
|
|
|
|
__all__ = ["emailgen_worker"]
|
|
|
|
|
|
def __getattr__(name: str) -> Any:
|
|
if name == "emailgen_worker":
|
|
from decnet.orchestrator.emailgen.worker import emailgen_worker as _w
|
|
return _w
|
|
raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
|