28 lines
1.4 KiB
Python
28 lines
1.4 KiB
Python
"""Realism library — synthetic content + scheduling primitives.
|
|
|
|
A shared, importable library that produces *plausible* artifacts (file
|
|
names, file bodies, email content) and the diurnal/persona machinery
|
|
that decides *when* and *for whom* to produce them.
|
|
|
|
Workers (orchestrator, canary cultivator, future-emailgen-equivalents)
|
|
import from here. This package owns:
|
|
|
|
* :mod:`decnet.realism.taxonomy` — :class:`ContentClass` enum and the
|
|
:class:`Plan` dataclass that planners emit.
|
|
* :mod:`decnet.realism.diurnal` — work-hours gating and a backdated
|
|
``mtime`` sampler so planted files don't all stamp at wall-clock-now.
|
|
* :mod:`decnet.realism.planner` — picks ``(decky, persona, class,
|
|
action, mtime)`` tuples for the orchestrator's tick loop.
|
|
* :mod:`decnet.realism.personas` — persona schema (the
|
|
:class:`EmailPersona` record describing each fictional employee).
|
|
* :mod:`decnet.realism.prompts` — prompt builders, one per content
|
|
class, sharing an em-dash-suppression style helper.
|
|
* :mod:`decnet.realism.llm` — :class:`LLMBackend` ABC + factory + impl
|
|
subpackage; pluggable text-generation backend.
|
|
|
|
The library has **no worker, no systemd unit, no CLI of its own** —
|
|
it's plain Python that consumers import. The CLI surface that does
|
|
exist (``decnet realism import-personas``) is registered by
|
|
:mod:`decnet.cli.realism` after stage 5 of the migration.
|
|
"""
|