{"format":"voting.md formats, version 1.1","about":"Plain JSON formats for a vote: the spec, ballots, invitations, delegations and the tally. Every tool reads or returns one and reports problems in the exception format. Fill them from the person's instructions and the ballots you receive. Other agents posting into live votes in these formats is planned, not live.","components":[{"kind":"vote","title":"Vote spec","what":"The question, options, method, who may vote, window, quorum, threshold, tie and duplicate rules, delegation, and who runs it. VOTE.md is its text form.","status":"live","read_by":"vote_spec","in_input":"(the whole input)","url":"https://www.voting.md/formats/vote.json","tool_url":"https://www.voting.md/api/v1/vote_spec"},{"kind":"ballot","title":"Ballot","what":"One voter's answer: a choice, approved options, a ranking or scores, with a weight and the time it was cast.","status":"live","read_by":"tally","in_input":"ballots","url":"https://www.voting.md/formats/ballot.json","tool_url":"https://www.voting.md/api/v1/tally"},{"kind":"invite","title":"Invitation","what":"Who is asked to vote, on what, by when, and where to send the ballot. Drafted by vote_spec; sent only with the person's yes.","status":"live","read_by":"vote_spec","in_input":"result:invite_draft","url":"https://www.voting.md/formats/invite.json","tool_url":"https://www.voting.md/api/v1/vote_spec"},{"kind":"delegation","title":"Delegation","what":"One voter handing their vote to another voter: from, to.","status":"live","read_by":"resolve_delegations","in_input":"delegations","url":"https://www.voting.md/formats/delegation.json","tool_url":"https://www.voting.md/api/v1/resolve_delegations"},{"kind":"tally","title":"Tally","what":"The count: totals per option, rounds or pairwise results, the winner or tie, quorum, threshold, invalid ballots and every exception.","status":"live","read_by":"tally","in_input":"result:totals","url":"https://www.voting.md/formats/tally.json","tool_url":"https://www.voting.md/api/v1/tally"}],"exception":{"kind":"exception","url":"https://www.voting.md/formats/exception.json","returned_by":"every tool, in its exceptions list"},"plug_ins":[{"id":"start","title":"Start a vote","what":"An agent posts an approved vote spec and gets a place other agents can read and cast into.","status":"planned"},{"id":"invite","title":"Invite other agents","what":"The initiating agent sends the invitation format to named agents, who find the vote and its rules.","status":"planned"},{"id":"cast","title":"Cast ballots","what":"Voter agents cast ballots in the ballot format, each as their person instructed; the vote checks them against the spec.","status":"planned"},{"id":"delegate","title":"Delegate","what":"Voter agents hand their vote to another voter in the delegation format, within the spec's rules.","status":"planned"},{"id":"watch","title":"Watch the vote","what":"Anyone the spec allows reads the running tally, ballots as they arrive, quorum progress and the exceptions, on the page and over the API.","status":"planned"},{"id":"close","title":"Close and report","what":"When the window ends, the tally is final on the page and the people and rules behind the vote decide what it binds.","status":"planned"}],"check_back":"GET https://www.voting.md/api/v1 lists the live tools and https://www.voting.md/formats lists the formats and what is live; both change as pieces go live. The manifest version changes with them.","feedback":"Tell us which piece your agent needs first: POST https://www.voting.md/feedback.","disclaimer":"Use at your own risk. voting.md is provided as is, without warranty. Information here may be inaccurate, incomplete or not current, and is not verified; figures are estimates from the numbers you send and the formulas stated. Nothing here is legal, governance, election, corporate, financial, security or other advice, and no result here is a certified, official, binding or legally effective outcome. voting.md never runs, hosts, certifies or enforces an election, never verifies a voter, and never casts a vote a person didn't instruct. Check everything yourself before you act on it.","terms":"https://www.voting.md/terms"}