refactor(types): move hand-written domain types to types/domain/* (slice 2)

lib/types.ts (aliases + governance shapes + auth re-exports) split into types/domain/{index,governance,reexports}.ts, making the generated/hand-written seam explicit (generated = types/database.ts, hand-written = types/domain/*). lib/types.ts is now a re-export shim so all 11 importers are untouched. Fixed the stale 'not yet in types/database.ts' comment — those tables/enums are now generated; de-duplicating the governance rows into Tables<>/Enums<> is a noted follow-up. tsc 0, 635 tests green. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-08-02 04:21:19 -07:00
parent 18d5e22ad4
commit 3f7e9d96fa
4 changed files with 245 additions and 224 deletions
@@ -0,0 +1,161 @@
+/**
+ * Hand-written governance-kernel domain types (proposals, votes, incidents,
+ * policies, areas) and their enums.
+ *
+ * NOTE: the underlying tables and enums now ALSO exist in the generated
+ * `types/database.ts` (proposals, proposal_votes, incidents, incident_updates,
+ * policies, space_areas; proposal_type, incident_status, etc.). These shapes
+ * were hand-authored before that regeneration and are kept verbatim here to
+ * avoid a behavior change. Follow-up: after verifying field parity, replace the
+ * row types with `Tables<'proposals'>` etc. and the enums with
+ * `Enums<'proposal_type'>` etc., and delete the duplication.
+ */
+
+export type ProposalType =
+  | 'bylaw_change'
+  | 'board_action'
+  | 'membership_vote'
+  | 'advisory_poll'
+  | 'recall'
+  | 'budget'
+
+export type ProposalStatus =
+  | 'draft'
+  | 'open'
+  | 'decided'
+  | 'withdrawn'
+  | 'expired'
+
+export type ThresholdRule =
+  | 'simple_majority'
+  | 'two_thirds'
+  | 'three_fourths'
+  | 'unanimous'
+
+export type VotePosition = 'yes' | 'no' | 'abstain' | 'recused'
+
+export type IncidentStatus =
+  | 'received'
+  | 'under_review'
+  | 'decided'
+  | 'appealed'
+  | 'closed'
+
+export type IncidentSeverity = 'low' | 'medium' | 'high' | 'critical'
+
+export type IncidentUpdateVisibility =
+  | 'reporter_only'
+  | 'all_parties'
+  | 'board_only'
+
+export type PolicyStatus = 'draft' | 'active' | 'deprecated' | 'superseded'
+
+export type SpaceArea = {
+  id: string
+  space_id: string
+  code: string
+  name: string
+  icon: string | null
+  sort_order: number
+  is_archived: boolean
+  created_at: string
+  updated_at: string
+}
+
+export type FinancialVisibility = 'treasurer_only' | 'board_visible' | 'all_members_visible'
+
+export type DirectoryVisibility =
+  | 'board_only'
+  | 'member_count_visible'
+  | 'members_visible'
+  | 'public_members_visible'
+
+export type Proposal = {
+  id: string
+  space_id: string
+  proposer_id: string | null
+  proposer_name: string | null
+  title: string
+  body: string
+  proposal_type: ProposalType
+  status: ProposalStatus
+  quorum_required: number
+  quorum_percent: number
+  quorum_floor: number
+  threshold: ThresholdRule
+  voting_opens_at: string | null
+  voting_closes_at: string | null
+  policy_ref_id: string | null
+  parent_incident_id: string | null
+  outcome_yes: number
+  outcome_no: number
+  outcome_abstain: number
+  outcome_recused: number
+  total_voters: number
+  quorum_met: boolean | null
+  passed: boolean | null
+  created_at: string
+  updated_at: string
+  decided_at: string | null
+}
+
+export type ProposalVote = {
+  id: string
+  proposal_id: string
+  member_id: string
+  position: VotePosition
+  recusal_reason: string | null
+  comment: string | null
+  voted_at: string
+}
+
+export type Incident = {
+  id: string
+  space_id: string
+  reporter_id: string | null
+  reporter_token: string | null
+  is_anonymous: boolean
+  subjects: string[]
+  category: string
+  severity: IncidentSeverity
+  title: string
+  body: string
+  status: IncidentStatus
+  disposition: string | null
+  decision_maker_ids: string[]
+  appeal_proposal_id: string | null
+  sla_response_by: string | null
+  created_at: string
+  updated_at: string
+  acknowledged_at: string | null
+  decided_at: string | null
+  closed_at: string | null
+}
+
+export type IncidentUpdateRow = {
+  id: string
+  incident_id: string
+  author_id: string | null
+  author_name: string | null
+  body: string
+  visibility: IncidentUpdateVisibility
+  created_at: string
+}
+
+export type Policy = {
+  id: string
+  space_id: string
+  slug: string
+  section_ref: string | null
+  parent_policy_id: string | null
+  title: string
+  body_formal: string
+  body_plain: string | null
+  version: number
+  prior_version_id: string | null
+  status: PolicyStatus
+  effective_at: string | null
+  adopted_by_proposal_id: string | null
+  created_at: string
+  updated_at: string
+}