Docs / Reference / Audit events
Reference For auditors

Audit events

Every state change in the factory appends one event to the audit log, with who did it, who was signed in, when, and the state it moved from and to. Events are never updated or deleted.

Each event has a code, which is stable and what an integration matches on, and a sentence, which is what the application and the API's event feed show a person. … stands for the event's subject — a requirement key, a source system, a release number.

Integrate on the code. Sentences are improved without notice; codes are not changed.

This list is generated from dpf/domain/events.py.

product

Code Reads as
product.created Product created
product.scope_set Scope set
product.sources_chosen Sources chosen
product.context_saved Context saved
product.questions_set Business questions set

demand

Code Reads as
demand.drafted Contract v0.1 drafted
demand.feedback Feedback on contract v0.1
demand.requested Access requested
demand.granted Access granted
demand.conditional Access granted with conditions
demand.denied Access denied
demand.simulated Owner's answer simulated

requirement

Code Reads as
requirement.created Requirement … created
requirement.revised Requirement … revised
requirement.proposed Requirement … proposed
requirement.accepted Requirement … accepted
requirement.retired Requirement … retired

design

Code Reads as
design.saved Data model saved

contract

Code Reads as
contract.drafted Contract drafted
contract.accepted Contract … agreed
contract.published Contract published as …

artifacts

Code Reads as
artifacts.generated Build artefacts generated

contract_draft

Code Reads as
contract_draft.edited Contract draft edited

proposal

Code Reads as
proposal.made Agent proposal
proposal.failed Agent proposal failed
proposal.started_by_hand Draft started by hand
proposal.accepted Proposal accepted
proposal.rejected Proposal rejected
proposal.partial Proposal partly accepted
proposal.requirements_accepted Requirements taken from proposal

release

Code Reads as
release.created Release … created
release.validated Release … validated
release.blocked Release … blocked
release.approved Release … approved
release.promoted Release … promoted
release.rollbackd Rolled back to release …
release.rolled_back Release … rolled back
release.superseded Release … superseded

signoff

Code Reads as
signoff.added Signatory added
signoff.requested Sign-off requested
signoff.signed Signed off
signoff.declined Sign-off declined

run

Code Reads as
run.passed Build passed
run.failed Build failed
run.error Build errored

result

Code Reads as
result.attributed Check result attributed

flag

Code Reads as
flag.raised Flag raised
flag.recurred Flag recurred
flag.cleared Flag cleared
flag.accepted Flag accepted
flag.resolved Flag resolved

token

Code Reads as
token.issued Service token issued
token.revoked Service token revoked
Documentation for version 0.2.0 Reviewed 2026-10-19 Covers dpf/domain/events.py, dpf/audit.py