Node journal

Full rules: octobot/community/node_journal/AGENTS.md.

Purpose

Append-only event log for diagnostics, journey analytics, and export/sharing (upload envelope). Not authoritative application state.

Integrators (outside node_journal/)

• Import octobot.community.node_journal and call Tier-1 record_* / record only.
• Do not call read_events, read journal files on disk, or branch product logic on journal contents.
• Do not store data in journal payloads to reuse later for non-journal features. Use config, DB, sync collections, or domain stores as source of truth.

Inside octobot/community/node_journal/

• read_events, build_journey_summary, and build_upload_envelope belong to the export pipeline (plus unit tests).
• Event and wire literals: extend events.py, constants.py, enums.py; do not inline strings in recording code.
• Respect import tiers in package __init__.py; feature code must not reach into store / state except via the public API.

Related

• Core app boundaries: octobot/AGENTS.md
• Python conventions (shared literals, imports): CONTRIBUTING-agent.md — Python conventions (agents)