Class AuditEntryModel

src/orgkernel/models.py:202–262

Stores individual AuditEntry records. Belongs to one AuditChain.

class AuditEntryModel(BaseModel):
    """
    Stores individual AuditEntry records. Belongs to one AuditChain.
    """

    __tablename__: str = "sys_orgkernel_audit_entry"
    __table_args__ = (
        Index("idx_entry_chain_id", "chain_id"),
        Index("idx_entry_chain_seq", "chain_id", "sequence"),
        Index("idx_entry_mission_id", "mission_id"),
        Index("idx_entry_agent_id", "agent_id"),
        {"comment": "OrgKernel AuditEntry — single immutable record in AuditChain"},
    )

    entry_id: Mapped[str] = mapped_column(
        String(32), primary_key=True, comment="aue_ prefixed global ID"
    )
    chain_id: Mapped[str] = mapped_column(
        String(32), nullable=False,
        comment="FK -> sys_orgkernel_audit_chain.chain_id",
    )
    sequence: Mapped[int] = mapped_column(
        Integer, nullable=False,
        comment="Monotonically increasing position in chain",
    )
    layer: Mapped[str] = mapped_column(
        String(16), nullable=False,
        comment="IDENTITY | EXECUTION | COMPLIANCE | GOVERNANCE",
    )
    event: Mapped[str] = mapped_column(
        String(128), nullable=False,
        comment="Event identifier, format: LAYER_EventName",
    )
    agent_id: Mapped[str] = mapped_column(
        String(32), nullable=False, index=True,
        comment="Agent that produced this entry",
    )
    mission_id: Mapped[str] = mapped_column(
        String(32), nullable=False, index=True,
        comment="Mission this entry belongs to",
    )
    token_id: Mapped[str | None] = mapped_column(
        String(32), nullable=True,
        comment="ExecutionToken active at this entry",
    )
    timestamp: Mapped[datetime] = mapped_column(
        DateTime, nullable=False,
        comment="UTC timestamp with microsecond precision",
    )
    data_json: Mapped[str | None] = mapped_column(
        Text, nullable=True,
        comment="Event data payload serialized as JSON",
    )
    prev_hash: Mapped[str] = mapped_column(
        String(64), nullable=False,
        comment="SHA-256 hash of previous entry",
    )
    entry_hash: Mapped[str] = mapped_column(