diff --git a/hubzilla/addon/vs01/vital-signs/VS-02-unit-size-voting-structure.json b/hubzilla/addon/vs01/vital-signs/VS-02-unit-size-voting-structure.json index 918ac38..bd534b8 100644 --- a/hubzilla/addon/vs01/vital-signs/VS-02-unit-size-voting-structure.json +++ b/hubzilla/addon/vs01/vital-signs/VS-02-unit-size-voting-structure.json @@ -5,7 +5,12 @@ "version": "1.0", "statute_primary": "765 ILCS 605/18", "diagnostic_question": "Is the membership large enough to produce qualified governance from its own pool — and does the voting structure reflect the actual interests of affected residents?", - "dsc_activations": ["DSC-01", "DSC-02", "DSC-04", "DSC-05"], + "dsc_activations": [ + "DSC-01", + "DSC-02", + "DSC-04", + "DSC-05" + ], "verification_sources": [ { "label": "Kane County Recorder of Deeds", @@ -18,11 +23,9 @@ "instruction": "Annual reports filed with the Secretary of State may list current officers and directors, which can be compared against claimed board composition." } ], - "renderer_notes": "VS-02 surfaces four distinct diagnostic conditions: (1) the gap between nominal unit count and effective voting population, (2) board self-voting on board-initiated decisions, (3) non-resident owner influence on conditions they do not experience, (4) structural quorum failure from chronic disengagement. Each condition has its own diagnostic flag. Render all four flag states visibly when triggered." + "renderer_notes": "VS-02 surfaces five distinct diagnostic conditions: (1) the gap between nominal unit count and effective voting population, (2) board self-voting on board-initiated decisions, (3) non-resident owner influence on conditions they do not experience, (4) structural quorum failure from chronic disengagement, (5) board composition inconsistency across Secretary of State filings. Each condition has its own diagnostic flag. Render all five flag states visibly when triggered." }, - "perspectives": { - "homeowner": { "label": "Your Record", "access_state": "participant", @@ -33,13 +36,8 @@ "label": "Total number of occupiable units in the association", "type": "number", "required": true, - "placeholder": "Enter the number or your best estimate" - }, - { - "id": "ho_total_units_estimated", - "label": "Is this an estimate?", - "type": "boolean", - "required": true + "default": 0, + "placeholder": "Enter the number" }, { "id": "ho_board_size", @@ -73,15 +71,17 @@ "label": "Approximate number of non-resident owner units", "type": "number", "required": false, - "depends_on": { "field": "ho_nonresident_owners_present", "value": true }, + "depends_on": { + "field": "ho_nonresident_owners_present", + "value": true + }, "placeholder": "Enter the number or your best estimate" }, { - "id": "ho_typical_meeting_attendance", - "label": "Approximately how many unit owners typically attend or participate in annual or special meetings?", - "type": "number", - "required": false, - "placeholder": "Enter the number or your best estimate" + "id": "ho_meeting_attendance_documented", + "label": "Do you hold or know of a written record — such as meeting minutes — that tracks attendance at meetings?", + "type": "boolean", + "required": false }, { "id": "ho_quorum_achieved", @@ -89,10 +89,22 @@ "type": "select", "required": true, "options": [ - { "value": "yes_documented", "label": "Yes — and it is documented in the minutes" }, - { "value": "yes_undocumented", "label": "Yes — but it was not documented or was ignored" }, - { "value": "no", "label": "No — quorum has always been achieved" }, - { "value": "unknown", "label": "I do not know" } + { + "value": "yes_documented", + "label": "Yes — and it is documented in the minutes" + }, + { + "value": "yes_undocumented", + "label": "Yes — but it was not documented or was ignored" + }, + { + "value": "no", + "label": "No — quorum has always been achieved" + }, + { + "value": "unknown", + "label": "I do not know" + } ], "diagnostic_flag": true, "flag_condition": "yes_undocumented", @@ -112,7 +124,10 @@ "label": "Describe what you observed.", "type": "textarea", "required": false, - "depends_on": { "field": "ho_quorum_manipulated", "value": true }, + "depends_on": { + "field": "ho_quorum_manipulated", + "value": true + }, "placeholder": "Example: Quorum was declared at the 2022 annual meeting with 8 of 35 owners present. The same board had previously canceled the 2021 meeting citing insufficient attendance." }, { @@ -131,7 +146,6 @@ } ] }, - "professional": { "label": "Professional Record", "access_state": "professional", @@ -149,12 +163,41 @@ "type": "select", "required": true, "options": [ - { "value": "one_per_unit", "label": "One vote per unit" }, - { "value": "weighted", "label": "Weighted by unit size or percentage interest" }, - { "value": "one_per_owner", "label": "One vote per owner regardless of units owned" }, - { "value": "other", "label": "Other — describe in notes" } + { + "value": "one_per_unit", + "label": "One vote per unit" + }, + { + "value": "weighted", + "label": "Weighted by unit size or percentage interest" + }, + { + "value": "one_per_owner", + "label": "One vote per owner regardless of units owned" + }, + { + "value": "other", + "label": "Other — describe in notes" + } ] }, + { + "id": "pro_board_filing_history", + "label": "Board member count as listed in each SoS annual report on file, by filing year", + "type": "textarea", + "required": false, + "placeholder": "One entry per line, year: count. Example:\n2021: 5\n2022: 6\n2023: 5" + }, + { + "id": "pro_board_composition_inconsistent", + "label": "Does the board size or composition vary across SoS filings in a way not explained by ordinary turnover?", + "type": "boolean", + "required": false, + "diagnostic_flag": true, + "flag_condition": true, + "flag_label": "Board composition inconsistent across SoS filings — governance record gap", + "flag_note": "Annual reports filed with the Secretary of State are a written record of who the association has represented as its officers and directors. Year-over-year inconsistency in headcount or role assignment beyond ordinary turnover is itself diagnostic of unstable or informally-run governance, independent of any single year's accuracy." + }, { "id": "pro_board_authority_source", "label": "Does the Declaration or Bylaws require homeowner approval for Special Assessments above a defined threshold?", @@ -169,9 +212,19 @@ "label": "Threshold amount requiring homeowner approval", "type": "text", "required": false, - "depends_on": { "field": "pro_board_authority_source", "value": true }, + "depends_on": { + "field": "pro_board_authority_source", + "value": true + }, "placeholder": "e.g. Special Assessments exceeding $10,000 require 2/3 membership approval per Article VI Section 3" }, + { + "id": "pro_verified_typical_attendance", + "label": "Verified typical meeting attendance, sourced from minutes or sign-in sheets on file", + "type": "number", + "required": false, + "placeholder": "Enter the number from the documented record" + }, { "id": "pro_quorum_threshold", "label": "Quorum threshold as defined in the Bylaws", @@ -208,10 +261,22 @@ "type": "select", "required": true, "options": [ - { "value": "confirmed", "label": "Confirmed — homeowner record is accurate" }, - { "value": "upgraded", "label": "Upgraded — condition is more significant than homeowner record indicates" }, - { "value": "downgraded", "label": "Downgraded — condition is less significant than homeowner record indicates" }, - { "value": "insufficient", "label": "Insufficient information — further verification required" } + { + "value": "confirmed", + "label": "Confirmed — homeowner record is accurate" + }, + { + "value": "upgraded", + "label": "Upgraded — condition is more significant than homeowner record indicates" + }, + { + "value": "downgraded", + "label": "Downgraded — condition is less significant than homeowner record indicates" + }, + { + "value": "insufficient", + "label": "Insufficient information — further verification required" + } ] }, { @@ -223,7 +288,6 @@ } ] }, - "public_record": { "label": "Public Record", "access_state": "operator", @@ -236,11 +300,26 @@ "type": "select", "required": true, "options": [ - { "value": "quorum_validity", "label": "Quorum validity" }, - { "value": "board_authority", "label": "Board authority — Special Assessment or contract" }, - { "value": "voting_rights", "label": "Voting rights structure" }, - { "value": "election_validity", "label": "Election validity" }, - { "value": "other", "label": "Other — describe in summary" } + { + "value": "quorum_validity", + "label": "Quorum validity" + }, + { + "value": "board_authority", + "label": "Board authority — Special Assessment or contract" + }, + { + "value": "voting_rights", + "label": "Voting rights structure" + }, + { + "value": "election_validity", + "label": "Election validity" + }, + { + "value": "other", + "label": "Other — describe in summary" + } ] }, { @@ -273,7 +352,6 @@ ] } }, - "spool": { "contract_version": "1.0", "addon": "vs01", @@ -285,6 +363,6 @@ "standing", "fields" ], - "notes": "Field keys match the field id values defined in this schema. Numeric fields submitted as estimates should carry an accompanying boolean flag field where provided — e.g. ho_total_units_estimated." + "notes": "Field keys match the field id values defined in this schema. ho_total_units uses a schema-level \"default\" of 0 rather than an estimate flag — the unit count is treated as a value that must be entered, not estimated." } -} +} \ No newline at end of file