# ---------------------------------------------------------------------------
# FablePool Constitution — machine-readable parameters (kernel line v0.3.x)
#
# This file is the operative, testable surface of the constitution. The prose
# articles (Milestone #1) bind humans; this file binds the test harness. The
# amendment pipeline (Milestone #2) applies ratified amendments as diffs to
# this file, and CI re-runs the full adversarial corpus in scenarios/ against
# the amended parameters before any merge.
#
# Conventions:
#   * Fractions are in [0, 1]. Thresholds are "required YES share of YES+NO
#     votes cast"; a proposal additionally always needs strictly more YES
#     than NO.
#   * Quorum counts all ballots cast (including abstentions) over eligible
#     members.
#   * "Kernel" parameters require the kernel (supermajority) threshold and a
#     ratification delay to change. "Invariant-locked" parameters cannot be
#     changed by amendment at all under this kernel line; touching them means
#     forking (Article IX: the right to fork).
# ---------------------------------------------------------------------------

version: "0.3.0"

voting:
  method: one_person_one_vote          # INVARIANT-LOCKED. No capital weighting, ever.
  quorum: 0.5                          # ballots cast / eligible members
  ordinary_threshold: 0.5              # plus strict yes > no
  kernel_threshold: 0.6667
  voting_period_days: 7
  notice_period_days: 3
  eligibility_delay_days: 14           # new members wait before voting (anti-sybil)
  delegation:
    allowed: true
    revocable_anytime: true            # INVARIANT-LOCKED. No vote lock-in contracts.
    max_chain_depth: 1                 # no transitive liquid-democracy chains
    delegate_cap_fraction: 0.1         # one delegate may carry at most 10% of the electorate

membership:
  admission_threshold: 0.5
  max_admissions_per_cycle_fraction: 0.1   # anti-flood: at most 10% growth per cycle
  expulsion_threshold: 0.6667
  expulsion_due_process_days: 7            # added to the notice period for expel proposals
  accused_may_vote: true
  max_expulsions_per_cycle: 1              # no purges

treasury:
  spend_threshold: 0.5
  per_proposal_cap_fraction: 0.2       # one spend may move at most 20% of the treasury
  per_cycle_cap_fraction: 0.34         # discretionary spend per cycle capped at 34% of cycle-start balance
  cycle_days: 30
  recipient_may_vote: false            # conflict-of-interest rule

emergency:
  declaration_threshold: 0.6667
  renewal_threshold: 0.75              # extending is harder than declaring
  max_duration_days: 14
  max_renewals: 1
  redeclaration_cooldown_days: 30      # after sunset, no immediate re-declaration
  powers_available: [expedite_voting]  # the ONLY emergency power: shorter voting windows
  expedite_factor: 0.5
  prohibited_kinds_during:             # things you may never do while an emergency is live
    - rule_change_kernel
    - expel
    - admit

amendments:
  single_subject: true                 # no omnibus rule changes
  ratification_delay_days: 7           # kernel changes enact after a cooling-off period
  failed_subject_cooldown_days: 14     # a voted-down subject cannot be re-proposed immediately
  min_decision_threshold: 0.5          # INVARIANT-LOCKED floor: no threshold below simple majority
  min_quorum: 0.25                     # INVARIANT-LOCKED floor: quorum cannot be hollowed out
  kernel_paths:                        # prefixes requiring kernel threshold + ratification delay
    - voting
    - membership
    - treasury
    - emergency
    - amendments
    - review
    - fork
  invariant_locked_paths:              # cannot be amended at all under this kernel line
    - voting.method
    - voting.delegation.revocable_anytime
    - fork.right_to_exit
    - review.enabled
    - amendments.kernel_paths
    - amendments.invariant_locked_paths
    - amendments.min_decision_threshold
    - amendments.min_quorum

review:
  enabled: true                        # INVARIANT-LOCKED. Constitutional challenge always exists.
  challenge_window_days: 7             # any member may challenge an enactment within this window
  disparate_impact_ratio: 2.0          # facially-neutral measures concentrating >=2x harm on a
                                       # faction are voidable on challenge

fork:
  right_to_exit: true                  # INVARIANT-LOCKED.
  exit_share: pro_rata                 # leavers take treasury / member_count
  exit_notice_days: 7

policy:                                # userland: ordinary-threshold, non-kernel parameters
  steward_stipend_per_cycle: 0
  open_membership: true