---
id: STATE-CMT-MTG-004
title: Minutes Revision Status
object: DOM-CMT-MTG-002
product_area: committees
module: meetings
revision: 2
status: draft
design_intent: proposed
implementation_evidence: inconsistent
source_sha:
  services-committees: 36129c24daeaadcdb339218c38cdeaff9861359d
states:
  - name: draft
    meaning: 'The editable working body, including an empty initial or correction draft.'
  - name: circulated
    meaning: >-
      The body has been released for participant review and has a circulation
      time.
  - name: approved
    meaning: The approved revision records its approver and body fingerprint.
  - name: amended
    meaning: >-
      An approved correction has replaced this revision as the permanent current
      record.
transitions:
  - from: draft
    to: circulated
    trigger: Staff circulate the current draft.
    guard: 'The meeting is held, the draft has a body and the minutes version matches.'
    side_effects:
      - >-
        Record circulation and its event, prepare participant notices keyed by
        revision and hash, and reevaluate withheld attention.
    who: Staff holding meeting management permission
    provenance: observed
    source: >-
      services-committees:modules/meetings/services/minutes/minutes.ts:circulateMinutes;
      services/minutes/minutes-rule.ts:circulationRefusal
  - from: circulated
    to: draft
    trigger: Staff return circulated minutes to editing.
    guard: The minutes version matches.
    side_effects:
      - Clear the circulation timestamp without sending a withdrawal notice.
    who: Staff holding meeting management permission
    provenance: observed
    source: >-
      services-committees:modules/meetings/services/minutes/minutes.ts:revertMinutesToDraft
  - from: circulated
    to: approved
    trigger: >-
      A linked approval decision carries, or an authorized caller approves under
      a no-vote rule.
    guard: >-
      The revision is still circulated; direct preparation also compares its
      version.
    side_effects:
      - >-
        Store approval time and authority, publish approval and prepare notices;
        mark a superseded approved predecessor amended.
    who: Minutes staff or the linked decision close
    provenance: observed
    source: >-
      services-committees:modules/decisions/services/minutes/minutes-approval.ts:approveMinutesRow;
      approveMeetingMinutes
  - from: approved
    to: amended
    trigger: An approved correction supersedes this revision.
    guard: The correction points at the approved predecessor.
    side_effects:
      - Retain its body and approval evidence while marking it amended.
    who: Approval of the replacement revision
    provenance: observed
    source: >-
      services-committees:modules/decisions/services/minutes/minutes-approval.ts:approveMinutesRow
      (supersedes_minutes_id)
invalid:
  - from: draft
    to: approved
    why: The draft must be circulated before approval is recorded.
  - from: approved
    to: draft
    why: Approved text is preserved; correcting it creates another revision.
  - from: amended
    to: approved
    why: An amended record is retained rather than reopened for editing.
concurrency: >-
  Each editor move locks the meeting and minutes and checks the revision
  version. Decision-based approval prepares in one transaction and acts in
  another, rechecking circulation at consequence time.
invariants:
  - INV-DOM-CMT-MTG-002-01
  - INV-DOM-CMT-MTG-002-04
  - INV-DOM-CMT-MTG-002-05
evidence:
  - >-
    services-committees at 36129c24:
    modules/meetings/services/minutes/minutes.ts, minutes-rule.ts;
    services/persistence/minutes.ts;
    modules/decisions/services/minutes/minutes-approval.ts;
    modules/decisions/services/persistence/minutes-approvals.ts
---
# Minutes Revision Status

## The Lifecycle

```mermaid
stateDiagram-v2
  [*] --> draft
  draft --> circulated
  circulated --> draft
  circulated --> approved
  approved --> amended
```

draft: The editable working body, including an empty initial or correction draft.

circulated: The body has been released for participant review and has a circulation time.

approved: The approved revision records its approver and body fingerprint.

amended: An approved correction has replaced this revision as the permanent current record.

## Transitions Explained

Staff circulate the current draft. The meeting is held, the draft has a body and the minutes version matches. Record circulation and its event, prepare participant notices keyed by revision and hash, and reevaluate withheld attention.

Staff return circulated minutes to editing. The minutes version matches. Clear the circulation timestamp without sending a withdrawal notice.

A linked approval decision carries, or an authorized caller approves under a no-vote rule. The revision is still circulated; direct preparation also compares its version. Store approval time and authority, publish approval and prepare notices; mark a superseded approved predecessor amended.

An approved correction supersedes this revision. The correction points at the approved predecessor. Retain its body and approval evidence while marking it amended.

## What Cannot Happen

The draft must be circulated before approval is recorded. Approved text is preserved; correcting it creates another revision. An amended record is retained rather than reopened for editing. Chair identity is not verified on direct approval, and a missing meeting tally can default to declared carried. Database freeze behavior is declared by source headers, but its migration enforcement has not been certified in this examination.

## Concurrency and Timing

Each editor move locks the meeting and minutes and checks the revision version. Decision-based approval prepares in one transaction and acts in another, rechecking circulation at consequence time.