Entity pillar · v0.16.0
entity-lifecycle EntityLifecycleEvent
Append-only lifecycle event record. File layout: `.corpospec/entity/lifecycle/<entity>/<YYYY-MM-DD>-<event>.yaml`. Never overwrite an existing file; corrections post a sibling `correction` event referencing the original via the `corrects` optional field.
$id · https://corpospec.com/schemas/v0.16.0/entity-lifecycle.schema.json
Fields
| Field | Type | Required | Description |
|---|---|---|---|
| content_hash | string | yes | SHA-256 of the canonicalised event payload (excluding this field). Establishes immutability outside Git. |
| effective_date | IsoDate | yes | When the event takes legal effect (notary deed date, registry-entry date, resolution date). |
| entity | PathRef | yes | The subject entity. |
| event | LifecycleEvent | yes | Which event this record captures. |
| id | PathRef | yes | PathRef identifier, conventionally `entity/lifecycle/<entity>/<YYYY-MM-DD>-<event>`. |
| corrects | PathRef? | — | When this event corrects an earlier event (rare; typically resolved via a sibling note rather than correction). |
| counterparty | PathRef? | — | Counterparty for merger / acquisition / demerger events. |
| document | PathRef? | — | PathRef into `legal/contracts/<slug>` for the deed, resolution, or certificate. |
| git_commit_sha | string? | — | Git commit SHA recorded by the pre-commit hook. |
| note | string? | — | Free-form note. |
| recorded_date | IsoDate? | — | When the record was authored. Defaults to commit date if unset. |
| registry_reference | string? | — | Registry reference (e.g. "HRB 765497 vom 2026-05-25"). |
Definitions
Shared types referenced within this schema.
IsoDate
ISO 8601 date (YYYY-MM-DD).
type: string
LifecycleEvent
The 19 typed lifecycle events an entity can undergo.
Each event records *when* it took legal effect (the notary deed date,
the registry-entry date, the resolution effective date). The
append-only log resolves the current entity status (`StatusActive`) by
folding from `formation_deed` through the latest unreversed event.
PathRef
Path-based cross-reference relative to .corpospec/ root.
Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
pattern: ^[a-z0-9_-]+(/[a-z0-9_.-]+)+$
Reference in your YAML
# yaml-language-server: $schema=https://corpospec.com/schemas/v0.16.0/entity-lifecycle.schema.json