Themis Domain — Features and Capabilities

Named after the Greek Titan goddess of divine law, natural order, and collective custom — daughter of Uranus and Gaia, and Zeus's counselor on matters of order and justice — Themis is a comprehensive governance, democracy, and compliance infrastructure platform. It provides 40 libraries spanning the full spectrum of human governance: from Decentralized Autonomous Organizations (DAOs) and cryptoeconomic voting mechanisms, through traditional indigenous governance systems, international institutions, corporate boardrooms, and AI-assisted democratic deliberation, to a Concordia-backed originality accept-gate for generated content.

Themis is governance-model-agnostic: it does not impose a single governance philosophy but provides primitives, frameworks, and simulation tools so that any organization — a community of ten people or a nation of millions — can design governance appropriate to their context.

At a Glance#

1. Core Governance Data Platform (@themis/core)#

The foundational data layer underpinning every other Themis module. All governance records, events, relationships, and entities are defined and stored here.

• Governance data models — Comprehensive type definitions for proposals, votes, organizations, participants, roles, and permissions. Designed to express governance from any political tradition without forcing Western democratic assumptions on non-Western governance structures.
• Event sourcing — Every governance action is recorded as an immutable, timestamped event. This enables complete audit trails, temporal queries ("what was the vote count at 3pm?"), and full replay of governance history for dispute resolution. No governance record can be altered retroactively.
• Graph structure — Relationships between governance entities are modeled as a traversable graph. Delegation chains, organizational hierarchies, voting blocs, and committee memberships can all be queried as graph paths. Useful for detecting concentration of power and analyzing influence networks.
• Database schema — Production-ready PostgreSQL schema with versioned migrations for all governance data. Schema supports multi-tenant governance instances in a single deployment.
• Entity lifecycle tracking — Every governance entity (a proposal, an organization, a constitution, a committee) has tracked lifecycle states from creation through amendment, suspension, and archival.

2. DAO Infrastructure (@themis/dao)#

Tools for building and operating Decentralized Autonomous Organizations — internet-native organizations whose rules are encoded in software and whose decisions are made by token holders or members through on-chain governance. A DAO differs from a traditional organization in that its governance rules are transparent, automatically enforced by smart contracts, and cannot be changed without a governance vote.

2.1 DAO Constitution and Structure#

• Constitution designer — Visual and programmatic DAO constitution design with structured articles, sections, and governance rules. Constitutions can be collaboratively drafted, version-controlled, and ratified through a formal process.
• Governance template library — Pre-built templates for common DAO structures: token-governed DAOs (like Compound or Uniswap, where voting power equals token holdings), multisig-controlled DAOs (like early Gnosis Safe, where a committee of keyholders makes decisions), committee-based DAOs with elected working groups, and hybrid structures combining multiple approaches.
• Legal wrapper advisor — Guidance on wrapping a DAO in a legal entity for real-world contracts and liability protection. Covers Wyoming LLC (first US state to recognize DAOs as legal entities), Cayman Foundation Company, Swiss Association, and Marshall Islands DAO LLC — each with different privacy, liability, and jurisdictional implications for founders and members.
• SubDAO architecture — Hierarchical sub-DAO structures with delegated authority, budget allocation, and reporting relationships. A main DAO might have SubDAOs for grants, technical development, marketing, and regional chapters, each with its own governance rules and budget.

2.2 Proposal Management#

• Proposal lifecycle manager — End-to-end management from draft through discussion, voting, execution, and post-mortem. Each stage has configurable time windows, quorum requirements, and escalation rules.
• Quality gates — Automated quality scoring against configurable criteria: Is the budget detailed? Is there a risk assessment? Have affected stakeholders been consulted? Low-quality proposals can be returned to draft before consuming community governance bandwidth.
• Proposal templates — Structured templates for the most common proposal types: funding requests, protocol parameter changes, membership additions, partnership proposals, and strategic direction changes.

2.3 Cross-Chain and Delegation#

• Cross-chain governance coordinator — Synchronize governance state and decisions across multiple blockchain networks. A DAO with governance tokens on Ethereum mainnet, Polygon, and Optimism can hold a single coordinated vote where all token holders participate regardless of which chain their tokens are on.
• Delegation strategy engine — Automated delegation optimization based on delegate expertise scores, historical voting alignment with delegator preferences, and communication quality. Helps token holders find the right delegates for their values without manually researching hundreds of candidates.
• Delegation analytics — Track delegation patterns, concentration risk (measured by Gini coefficient of delegation), and delegate utilization rates over time.

3. Voting Mechanisms (@themis/voting)#

The most comprehensive voting system library in the Themis stack, supporting everything from simple yes/no ballots to sophisticated cryptoeconomic mechanisms. Every mechanism is backed by a complete implementation of the voting rules, tally logic, and edge case handling (ties, quorum failure, invalid ballots).

3.1 Standard Voting Methods#

• Universal ballot system — Multi-format ballots supporting yes/no binary votes, multiple choice (select one), approval voting (approve/disapprove each option independently), ranked preference lists, and weighted allocation (distribute a budget of points across options).
• Token-weighted voting — ERC-20 and ERC-721 token-weighted vote counting using snapshot-based balances taken at proposal creation time. Snapshot prevents flash loan attacks where an attacker borrows tokens to inflate their voting power for a single block.
• Multi-signature voting — Committee-based M-of-N voting (requires M approvals from a committee of N members) for executive decisions requiring a defined subset of authorized signers to agree.
• Approval voting — Each voter approves any number of options; options exceeding an approval threshold pass simultaneously. Approval voting reduces strategic voting compared to plurality systems because voters can honestly support all acceptable options.
• Ranked-choice voting (RCV) — Instant-runoff elimination: voters rank candidates in preference order; the lowest-ranked candidate is eliminated each round and their votes redistributed until a candidate has a majority. Standard for contested elections where splitting votes between similar candidates would otherwise cause the weakest to win.
• Condorcet method — Pairwise comparison method: the candidate who beats every other candidate head-to-head wins. Includes Schulze cycle resolution algorithm for cases where no clear Condorcet winner exists (a voter preference cycle: A beats B, B beats C, C beats A).

3.2 Advanced Cryptoeconomic Mechanisms#

These mechanisms are designed to overcome known pathologies of simple token-weighted voting — plutocracy (rich entities dominate), low participation (most token holders never vote), and governance attacks (coordinated bad actors exploit governance).

• Quadratic voting (QV) — Voters receive a budget of "voice credits." Casting N votes on a single issue costs N² credits, making it exponentially expensive to dominate any one decision while allowing voters to signal how strongly they care about different issues. A voter who cares deeply about one issue can concentrate credits there at high cost. Pioneered by Glen Weyl and Vitalik Buterin as a solution to one-dollar-one-vote plutocracy.
• Conviction voting — Continuous, stake-weighted signaling where conviction (voting weight) accumulates the longer tokens are staked toward a proposal. Last-minute token staking has little effect; long-term supporters carry more weight. Avoids snapshot manipulation and encourages sustained community engagement. Used by 1Hive Gardens and Commons Stack communities.
• Holographic consensus — Scalable governance using attention markets: before reaching the full DAO, proposals must attract staked attention from predictors who bet on whether they will pass. High-stakes or controversial proposals pass through full governance; routine proposals are resolved locally by those paying attention. Used by DAOstack to avoid governance overload in large DAOs.
• Optimistic governance — Proposals pass automatically after a silent period unless formally challenged. A challenge triggers a full vote. Dramatically reduces governance overhead for non-controversial decisions. Used by Optimism's governance and many rollup protocol DAOs.
• Vote-escrowed governance (veModel) — Governance power is tied to both token amount and time-lock duration. Locking tokens for 4 years grants far more governance power than locking for 1 week, aligning governance influence with long-term protocol commitment. Pioneered by Curve Finance (veCRV) and widely adopted across DeFi governance.

3.3 Liquid Democracy#

• Liquid democracy — Transitive delegation chains where delegated votes flow through multiple intermediaries. Alice delegates to Bob, Bob delegates to Carol — Carol votes with Alice's and Bob's combined weight. Delegates with high reputation automatically accumulate influence from many delegators, creating expert representatives without requiring fixed delegation.
• Topic-scoped delegation — Delegate voting power on specific governance domains to different domain experts. Delegate technical decisions to a trusted developer, treasury decisions to a financial expert, while retaining personal control over strategic direction decisions.
• Delegation with override — Delegates vote on the delegator's behalf by default, but delegators can override any specific vote before the voting window closes. Provides delegation convenience without surrendering democratic agency.
• Delegation visualization — Interactive visual representation of delegation chains, showing influence flow, power concentration, and single points of failure in the delegation graph.

4. Reputation and Delegate Scoring (@themis/reputation)#

Governance participation quality matters as much as quantity. Themis tracks multi-dimensional reputation to surface trustworthy delegates and incentivize high-quality governance participation over mere token accumulation.

• Delegate scoring system — Composite score across four dimensions: participation rate (shows up to vote on proposals), alignment score (votes consistently with their stated principles and past commitments), proposal quality (submits well-researched, clearly written, internally consistent proposals), and communication quality (explains voting rationale clearly to delegators).
• EigenTrust reputation — Distributed reputation propagation using the EigenTrust algorithm from peer-to-peer networks. Trust flows through delegate networks: delegates trusted by many high-trust participants earn high reputation even without a long individual history. Resistant to gaming because trust can only flow outward from already-trusted sources, not be self-assigned.
• Participation analytics — Granular tracking of participation rates, vote timing (early voter vs. last-minute voter), discussion thread contributions, and proposal involvement across time and governance instances.
• Reputation portability — Export and import reputation scores across platforms using standardized verifiable credentials. A delegate with a strong Compound Finance governance record can present that credential when running as a delegate in a new DAO, bootstrapping trust.

5. Decision Frameworks (@themis/decisions)#

Tools for improving the quality of governance decisions, not just the mechanical process of making them.

• Multi-Criteria Decision Analysis (MCDA) — Weighted scoring across multiple evaluation criteria with sensitivity analysis. Organizations structure complex choices by defining their values quantitatively and seeing how different options score. Sensitivity analysis reveals which criteria most influence the final ranking.
• Prediction market engine — Internal prediction markets where participants stake tokens on predicted proposal outcomes. Markets aggregate distributed information into probability estimates and create financial incentives for participants to reveal their true beliefs rather than vote with their social group.
• Futarchy — Full futarchy implementation: governance decisions are made by asking "which option will best achieve our stated goals?" rather than "which option do members prefer?" Prediction markets forecast goal achievement under each option; the best-forecast option is implemented. Proposed by economist Robin Hanson as a more outcome-oriented democracy.
• Decision quality tracking — Records actual outcomes against pre-decision predictions, building institutional calibration data over time. Organizations can empirically measure which governance participants and processes produce the best outcomes.

6. Deliberative Democracy (@themis/deliberation)#

Discussion and deliberation infrastructure that helps communities form considered collective opinions rather than just aggregating unconsidered first reactions. Deliberative democracy differs from direct democracy in that it emphasizes informed dialogue before voting, not just preference aggregation.

• Structured discussion platform — Forums with threaded discussion, moderation tools, time-boxed phases (open discussion → synthesis → voting), and automated synthesis reports summarizing key arguments.
• Argument mapping — Visual argument maps showing logical relationships between claims: premises, conclusions, supporting arguments, objections, and qualifiers. Helps participants understand the full structure of a debate rather than engaging only with positions they already agree with.
• Opinion clustering (Polis-style) — Statistical clustering of participant opinions to identify genuine consensus positions and bridging statements that unite divided groups. Rather than surfacing polarized debate, Polis-style analysis finds where diverse people actually agree, enabling constructive common ground.
• Citizen assembly management — Sortition-based (randomly selected) assembly management: random participant selection from a qualified pool ensures demographic representativeness regardless of who self-selects to participate. Manages structured deliberation phases with expert testimony, facilitated small groups, and final recommendation recording.
• Tech-enhanced deliberation — Real-time translation for multilingual assemblies, accessibility features for participants with disabilities, and asynchronous deliberation support for participants across time zones.
• Participatory process designer — Compose custom participatory processes by combining discussion, deliberation, voting, and feedback phases with configurable rules, timing, and participation requirements.
• AI deliberation assistant — AI-powered facilitation that summarizes long discussion threads, extracts key unresolved questions, identifies consensus positions, and flags perspectives that have not yet been represented in the debate.

7. Constitutional Frameworks (@themis/constitutions)#

7.1 Authoring#

• Charter authoring — Visual and code-based editor for writing constitutions with structured articles, sections, clauses, and definitions. Documents can be collaboratively edited with tracked changes and version history.
• AI-assisted drafting — AI suggests relevant clauses from the clause library, identifies gaps in constitutional coverage (e.g., no amendment procedure defined, no dispute resolution mechanism specified), and checks for internal logical inconsistencies.
• Clause library — Reusable, tested clauses for common constitutional needs: membership definitions, voting thresholds, treasury management rules, dispute resolution processes, amendment procedures, and dissolution conditions.

7.2 Lifecycle Management#

• Version control — Full version history with diff viewing between any two versions. Previous versions can be restored. Git-style branching supports experimental constitutional amendments without affecting the ratified constitution.
• Amendment lifecycle — Formal amendment process: proposal → community debate → public comment period → ratification vote → implementation. Each stage has configurable requirements and time windows ensuring deliberation before change.
• Jurisdictional compliance checking — Checks constitutional provisions against the legal requirements of the chosen legal wrapper. For example, the Wyoming DAO LLC statute requires specific provisions about member liability limitations; this tool flags missing required provisions.

7.3 Computational Governance#

• Computational law compiler — Compiles human-readable governance rules written in a structured natural language format into executable code or smart contract parameters. Rules like "proposals require 5% of total supply to pass" become deployable contract configurations.
• Governance rule simulator — Simulates how governance rules interact with each other and produce edge cases before adoption. Tests whether quorum and threshold settings make governance impossible under realistic participation rates, or whether they can be gamed.
• Smart contract generation — Generates governance smart contracts from constitutional clauses for EVM-compatible blockchains. The generated contracts encode the governance rules in executable form.

8. Governance Identity (@themis/identity)#

• Decentralized identity (DID) — W3C DID (Decentralized Identifier) standard-based identity for governance participation. Participants control their own identifiers without relying on centralized identity providers that could revoke access or be compelled to reveal user data.
• Eligibility engine — Configurable voter eligibility determination: who qualifies to participate based on token holdings, membership status, proof-of-personhood, geographic residency, or other criteria.
• Governance credential issuer — Issues verifiable credentials for governance roles: committee member, elected delegate, working group lead. Credentials are cryptographically verifiable and portable across platforms using W3C Verifiable Credentials standard.
• Sybil resistance — Mechanisms to prevent one person from creating many fake identities to amplify their governance power (a Sybil attack). Integrates with Proof of Humanity, BrightID, World ID, and other proof-of-personhood systems that verify unique human identity without revealing personal data.

9. Accountability and Integrity (@themis/accountability)#

• Governance integrity monitor — Real-time monitoring of governance integrity metrics: voting power concentration, quorum trends, delegate inactivity rates, proposal quality scores, and participation demographic distribution.
• Promise accountability — Tracks official promises and campaign commitments against actual votes and actions. Public accountability dashboard for any elected or appointed governance participant. Journalists and community members can query the full record.
• Governance quality index — Composite governance quality score combining participation health, decision quality, representation breadth, process adherence, and outcome track record.
• Secure whistleblower protection — Anonymous submission channel with cryptographic protection. Whistleblowers submit evidence without revealing identity; submissions are routed to appropriate oversight bodies with chain-of-custody documentation.
• Veritas-Governance bridge — Cross-domain integration: Veritas journalism data feeds governance accountability records. Fact-checked claims about governance participants are surfaced in Themis accountability dashboards, and governance anomalies detected by Themis are published to Veritas journalists.

10. Transparency and Audit Trails (@themis/transparency)#

• Campaign finance transparency — Campaign finance disclosure tracking for governance participants who accept funding for their governance role. Automatically surfaces conflicts of interest between funding sources and voting patterns.
• Governance open data portal — Open data API publishing all governance records (proposals, votes, decisions, financial transactions) in machine-readable formats for public accountability, academic research, and journalism.
• Immutable audit trail — Blockchain-anchored immutable audit logs ensuring governance records cannot be retroactively altered. Uses Merkle tree commitments published to a public blockchain so any third party can verify records have not been tampered with.
• Lobbying transparency — Disclosure and tracking of lobbying activity: who met with whom, what was discussed, what positions were advocated, and how those meetings correlate with subsequent governance votes.
• Public records management — Full public records lifecycle from creation through retention and archival, compliant with records retention laws in configured jurisdictions.

11. Privacy in Governance (@themis/privacy)#

Governance sometimes requires privacy — sensitive deliberations, protected votes, and confidential negotiations — balanced against the public accountability demands of democratic legitimacy.

• Confidential governance channels — End-to-end encrypted channels for sensitive governance discussions (executive session, personnel decisions, security disclosures) with defined access control lists and automatic decryption key rotation.
• MACI anti-collusion infrastructure — Minimum Anti-Collusion Infrastructure: a cryptographic protocol making vote-buying ineffective. Even if a voter sells their vote to a buyer, the voter can secretly change their vote afterward and the buyer cannot detect this. Originally developed by Barry Whitehat and Ethereum Foundation researchers for quadratic funding rounds.
• Private delegation — Zero-knowledge proof-based delegation where delegation relationships are private on-chain. A delegator can delegate without publicly revealing who their delegate is, preventing social pressure to delegate to particular powerful actors.
• Verifiable off-chain governance — Off-chain voting with on-chain settlement. Voting happens off-chain for gas cost efficiency; the final tally is committed on-chain with a cryptographic proof that the off-chain voting process was followed correctly.
• ZK anonymous voting — Zero-knowledge anonymous voting where voters prove eligibility (e.g., they hold sufficient tokens) without revealing their identity. Prevents retaliation and coercion in governance decisions involving powerful and potentially vindictive parties.
• V2 data-subject-rights workflow — Access, erasure, portability, and rectification requests are modeled in @themis/privacy and routed by V2 through @v2/themis-privacy-dsr-routing with @oshun/data-residency supplying the subject-home route.

12. Traditional and Indigenous Governance (@themis/traditional)#

Governance systems developed over centuries by human communities contain deep wisdom about collective decision-making that modern governance design often ignores. Themis models these systems to make their principles available for contemporary governance design.

• Haudenosaunee (Iroquois Confederacy) — The Great Law of Peace: consensus-based confederacy of six nations with clan mothers holding veto power over war decisions. One of history's most sophisticated federal governance systems, predating and influencing the U.S. Constitution. Models the roles of sachems (chiefs), clan mothers, and the confederate council.
• Ubuntu governance — Southern African communitarian governance philosophy: "I am because we are" (Ubuntu). Decisions are reached through extended community dialogue (indaba) with a goal of genuine consensus rather than majority rule. Models the distinction between Ubuntu consensus (all affected parties genuinely agree) and Western majority rule.
• Māori tikanga governance — New Zealand Māori customary law and decision-making processes including hui (community gathering for collective decision-making), whakaaro (deliberation and considered thinking), and kaitiakitanga (guardianship responsibilities toward the natural world and future generations).
• Customary law integration — Tools for integrating customary law with statutory law frameworks. Enables communities operating in both traditional and modern legal contexts to govern consistently across both systems without forcing one to override the other.
• Religious governance models — Governance frameworks from major religious traditions: Catholic conciliar governance (councils, synods, papal authority), Islamic shura (obligatory consultation principle), and Buddhist sangha governance (community rules, consensus processes).
• Non-Western governance systems — Confucian meritocratic governance (governance by those with demonstrated virtue and competence), African communitarian decision-making, and Islamic consultative governance paradigms implemented as configurable framework primitives.

13. Digital and Platform Governance (@themis/digital)#

• Platform content governance — Social platform content moderation governance models: who decides what content is allowed, through what process, with what appeals rights. Models include community juries (randomly selected users vote on contested moderation decisions), editorial boards (appointed expert committees), and hybrid human-AI systems.
• Algorithmic governance — Accountability frameworks for algorithmic decision systems: what decisions is the algorithm making, who is affected, what recourse exists, how is bias monitored, and who can challenge a decision.
• AI governance systems — Governance and oversight mechanisms for AI systems including approval processes for new AI capabilities, human-in-the-loop requirements for high-stakes decisions, and incident response governance.
• Autonomous systems governance — Governance frameworks for autonomous vehicles, drones, and robotic systems (see Galatea domain) operating in public spaces where harm is possible.
• Internet governance — ICANN, IETF, and W3C multi-stakeholder governance model implementation for technical coordination without centralized authority.
• Open source governance — Apache Software Foundation, Linux Foundation, and CNCF governance models for community-maintained open source projects with diverse contributor bases.
• Data governance frameworks — Data sovereignty, data trusts, and cooperative data governance frameworks for communities managing shared data assets and asserting collective rights over data.

14. International Governance (@themis/international)#

• International organizations — Structural models for UN, European Union, African Union, and ASEAN governance including voting weights, veto rights, and decision procedures. The UN Security Council veto mechanism, the EU qualified majority voting system, and the AU consensus principle are all modeled.
• Treaty lifecycle — Treaty negotiation, ratification, reservation management, and compliance tracking. Models both bilateral and multilateral treaty structures including entry-into-force conditions and withdrawal procedures.
• Diplomatic governance — Diplomatic protocol, bilateral commission governance, and multilateral negotiation modeling.
• Sovereignty models — Sovereignty frameworks including shared sovereignty (EU-style), federal systems (US, Germany, Nigeria), autonomy arrangements (Hong Kong, Catalonia), and international territorial administration (Kosovo).
• Trade governance — WTO dispute settlement procedures, regional trade agreement governance (ECOWAS, AfCFTA), and rules of origin administration.
• International financial governance — IMF quota and voting system, World Bank operational governance and safeguards, and multilateral development bank governance models.
• Global commons governance — Elinor Ostrom-inspired governance for global commons resources: high seas fisheries, atmospheric carbon, Antarctic scientific cooperation, lunar resource governance. Models Ostrom's eight design principles for sustainable commons management.
• Collective action modeling — Game theory models of international collective action problems including the tragedy of the commons in climate coordination, pandemic preparedness coordination, and nuclear non-proliferation.

15. Justice Systems (@themis/justice)#

• Judicial system architecture — Court system modeling supporting common law (UK, US, Ghana, Nigeria — adversarial, judge-made law), civil law (France, Germany, most of continental Europe and Latin America — codified, inquisitorial), and Islamic law traditions. Models judicial appointment processes, jurisdiction, standing rules, and appeals structures.
• Legal traditions comparison — Comparative law engine contrasting legal traditions with structured analysis of how the same legal question is answered differently under each tradition.
• Criminal justice governance — Criminal justice policy modeling covering charging decisions, bail system design, sentencing frameworks, correctional governance, and recidivism reduction policy.
• Judicial independence — Safeguard frameworks for judicial independence: appointment process design (judicial commissions vs. political appointments vs. elections), tenure security, financial independence, and recusal rules.
• Transitional justice — Post-conflict transitional justice governance: truth and reconciliation commissions (South Africa TRC model), hybrid courts (Sierra Leone Special Court model), reparations programs, and lustration (vetting former regime officials) processes.
• Reparations governance — Reparations policy design including beneficiary identification methodology, quantum determination (how much is owed), delivery mechanisms, and independent oversight.
• Access to justice — Legal aid program design, public defender systems, and pro bono governance frameworks for closing the gap between legal rights and practical access.

16. Dispute Resolution (@themis/arbitration)#

• Decentralized arbitration court — Kleros-style decentralized arbitration where randomly selected jurors drawn from a staked pool resolve disputes using a Schelling point mechanism. Jurors who vote with the majority earn token rewards; jurors who vote against the majority lose their stake. Coordination on the "obvious" correct answer creates incentives for honest adjudication.
• Dispute lifecycle manager — Full dispute lifecycle from claim filing through evidence submission, arbitration, decision, appeal, and enforcement.
• Multi-tier escalation — Configurable escalation paths: peer mediation → community moderation → arbitration → formal adjudication. Each tier has higher authority, higher costs, and longer timelines.
• Restorative justice processes — Restorative justice facilitation: structured conversations between those who caused harm and those affected, focused on repairing relationships and community rather than punishment alone. (Complements the Kuanyin domain's individual rehabilitation pathways.)
• Structured mediation — AI-facilitated structured mediation with impartial framing, interest identification, and solution generation support for parties who prefer negotiated settlement.

17. Corporate Governance (@themis/corporate)#

• Committee governance — Board committee management: audit, compensation, nomination, risk, and sustainability committees with documented charters, member tracking, and performance assessment.
• Digital board platform — Digital board meeting management: agenda construction, pre-reading distribution, video conferencing integration, minute-taking, resolution logging, and resolution tracking.
• ESG compliance engine — Environmental, Social, and Governance compliance tracking against GRI Standards, SASB frameworks, TCFD recommendations, and EU Corporate Sustainability Reporting Directive (CSRD) requirements.
• ESG integration engine — Integrates ESG metrics into corporate strategy, capital allocation, and executive compensation to embed sustainability into governance structure rather than treating it as a separate reporting exercise.
• Fiduciary duty monitoring — Tracks director decisions against fiduciary duty standards (duty of care: being informed and deliberate; duty of loyalty: acting in the company's interest, not personal interest) and flags potential conflicts of interest.
• Proxy voting infrastructure — Shareholder proxy voting system with voting instruction form distribution, vote collection, ISS/Glass Lewis governance score integration, and engagement analytics.
• Shareholder engagement — Shareholder communication management covering AGM coordination, activist investor response, and institutional investor dialogue.

18. Nonprofit and Cooperative Governance (@themis/nonprofit)#

• Benefit corporation governance — B-Corp governance standards (companies legally required to consider stakeholders beyond shareholders), impact measurement frameworks, and stakeholder accountability reporting.
• Cooperative governance — Worker cooperative and consumer cooperative governance on the one-member-one-vote principle, covering meeting management, board elections, profit distribution governance, and dispute resolution.
• Fiscal sponsorship — Fiscal sponsorship governance frameworks for pre-formation organizations receiving tax-advantaged donations through a sponsor organization.
• Grant governance — Grant-making governance covering application review, selection criteria, disbursement conditions, reporting requirements, and impact measurement.
• Mondragon federation governance — Mondragon cooperative federation model with sectoral congresses, cooperative council, and inter-cooperative solidarity mechanisms. Mondragon is one of the world's largest worker cooperative federations, based in the Basque Country.
• Nonprofit board governance — Nonprofit board composition, term limits, conflict of interest policies, and state law compliance for nonprofit boards.

19. Community Governance (@themis/community)#

• Association governance — Professional association governance: membership categories, member rights, board elections, standards committees, and ethics oversight.
• Community organization toolkit — Community organizing tools and governance frameworks for neighborhood associations, tenant organizations, and grassroots civic groups.
• Housing association governance — HOA and housing cooperative governance: meeting requirements, reserve fund management, maintenance decision processes, and dispute resolution.
• Labor union governance — Union election management, collective bargaining ratification processes, steward election procedures, and strike authorization votes.
• Sports club governance — Sports club governance for both member-owned clubs (like FC Barcelona or the Green Bay Packers) and community-based sports associations.

20. Civic Participation (@themis/civic)#

• Digital democracy platform — Civic participation digital platform combining deliberation, participatory budgeting, and direct democracy features for local governments and civic organizations.
• E-government layer — Integration layer connecting governance processes with government digital service delivery, enabling governments to run legally valid digital consultations and votes.
• Election management system — Full election administration: voter registration, ballot design, voting operations, result tabulation, and certification. Supports both in-person and online voting with appropriate security measures for each.
• Legislative monitoring — Bill tracking, parliamentary vote analysis, committee membership monitoring, and government action monitoring for legislative advocacy organizations and journalism.
• Participatory budgeting — Full participatory budgeting cycle: idea submission → community prioritization → project voting → budget allocation → implementation tracking → outcome reporting. Used by hundreds of cities worldwide to give residents direct say over public spending.

21. Sector-Specific Governance (@themis/sectors)#

Nine specialized governance frameworks for sectors with unique governance requirements:

• Military and security governance — Civil-military relations frameworks, operational oversight, and security sector reform governance ensuring democratic accountability over armed forces.
• Health systems governance — Hospital board governance, public health emergency governance, and healthcare resource allocation decision-making including rationing criteria.
• Financial and monetary governance — Central bank independence models, monetary policy committee governance, and financial stability board governance structures.
• Urban and municipal governance — City council governance, zoning decision processes, and participatory city planning frameworks.
• Media regulation governance — Independent media regulatory body governance, licensing decision processes, and content standards enforcement. Relevant to Veritas domain operations.
• Property and land rights governance — Land tenure systems, community land trust governance, and indigenous land rights governance frameworks.
• Behavioral nudge governance — Ethical oversight for behavioral nudge design and default-setting decisions affecting large populations (e.g., organ donation opt-out defaults, retirement savings enrollment).
• Representation and inclusion governance — Quota systems, proportional representation design, and inclusion policy governance.
• Civil society and advocacy governance — Coalition governance, advocacy alliance decision-making, and multi-stakeholder initiative governance.

22. Treasury Management (@themis/treasury)#

• Participatory budget governance — Participatory budgeting cycles with proposal submission, community prioritization voting, budget allocation, and spending reporting. Enables communities to collectively decide how their shared resources are spent.
• Spending controls — Multi-signature spending approval with configurable thresholds by amount and category. Large expenditures require more signatories than small ones, scaling security to risk level.
• Treasury diversification — Treasury asset diversification strategy governance: what percentage of treasury assets should be in stable assets, volatile assets, or real assets. Models protocols for executing diversification without market impact.
• Fiscal transparency dashboard — Real-time fiscal transparency reporting showing budget allocation, actual spending by category, reserve levels, and projected runway.

23. Public Goods Funding Mechanisms (@themis/funding)#

These mechanisms fund public goods — things that benefit everyone but that markets typically under-produce because they are non-excludable and non-rival.

• Quadratic funding — Gitcoin Grants-style quadratic funding rounds: individual donations are matched by a shared pool using a quadratic formula so that many small donations unlock proportionally more matching than a few large donations. This surfaces community-valued projects rather than well-funded ones. The matching formula is: match = (sum of square roots of individual donations)².
• Retroactive public goods funding — Retroactive PGF (the Optimism model): it is easier to evaluate what has already been valuable than to predict what will be valuable. Funding is awarded after demonstrated impact, creating incentives for public goods creation without requiring upfront specification of what to build.
• Hypercert impact certificates — Issue and trade Hypercerts: verifiable, non-fungible records of past impact that can be retrospectively funded. Enables impact investors to purchase proof of past positive impact and fund creators who delivered it.
• Augmented bonding curves — Augmented Bonding Curves for continuous organizational funding: a token bonding curve that splits incoming buy orders between an organizational reserve and a funding pool, creating a continuous funding stream proportional to community growth.
• Governance funding streams — Streaming governance fund distribution using Superfluid or similar real-time finance protocols: allocations flow as real-time token streams rather than lump-sum disbursements, improving accountability and enabling real-time reallocation.

24. Environmental Governance (@themis/environmental)#

• Climate governance frameworks — Paris Agreement compliance governance, national climate plan implementation tracking, and corporate climate commitment governance with standardized measurement and reporting.
• Digital commons governance — Governance for shared digital infrastructure: open data platforms, shared APIs, and community-maintained digital resources modeled as commons.
• Environmental impact assessment governance — EIA process governance for development projects, covering scoping, assessment, public participation requirements, and final decision-making accountability.
• Intergenerational equity mechanisms — Governance mechanisms giving voice to future generations: long-term impact committees, Future Generations Commissioner models (as implemented in Wales), and constitutional provisions for intergenerational equity.
• Natural resource extraction governance — Extractive industries governance covering revenue sharing, community benefit agreements, and environmental compliance monitoring.
• Operational commons governance — Elinor Ostrom's 8 design principles for sustainable commons governance, implemented as configurable framework primitives for managing fisheries, forests, water systems, and other shared natural resources.

25. Crisis Governance (@themis/crisis)#

• Emergency powers framework — Emergency powers activation procedures with mandatory sunset clauses, legislative oversight requirements, and automatic expiration provisions. Designed to prevent emergency powers from becoming permanent through constitutional entrenchment safeguards.
• Pandemic governance — Public health emergency governance protocols covering declaration triggers, response authority allocation, quarantine powers, and deescalation procedures.
• Government continuity — Continuity of government planning covering succession, relocation, emergency operations, and essential function continuation under extreme disruption scenarios.
• Leadership succession — Leadership succession protocol management for organizations whose leaders become unavailable unexpectedly.
• Governance failure analysis — Structured post-mortem governance failure analysis: what governance mechanisms failed, why, and what structural reforms could prevent recurrence.
• Post-conflict state building — Transitional governance frameworks for post-conflict situations: interim governments, constitutional assembly processes, and institution-building roadmaps based on comparative case study evidence.
• Democratic resilience — Stress-testing democratic institutions against authoritarian capture, foreign interference, judicial overreach, and executive aggrandizement.

26. Policy Analysis and Simulation (@themis/policy)#

• Computational law engine — Executable policy specification language allowing policies to be written in structured natural language that can be compiled into executable rules. Policies can be tested before adoption.
• Policy analysis engine — Policy impact analysis with cost-benefit modeling, distributional analysis (who gains and who loses), and second-order effects identification.
• Policy simulation engine — Agent-based policy simulation where thousands of simulated heterogeneous agents respond to policy interventions, producing emergent behavioral outcomes that reveal unintended consequences.
• Regulatory monitoring — Regulatory change monitoring and alerting: track proposed regulations, comment periods, and enacted changes affecting configured jurisdictions and industries.

27. Governance Analytics (@themis/analytics)#

• Voter behavior analytics — Pattern analysis of voting behavior: who votes with whom, coalition formation patterns, swing vote identification, and participation trends over time.
• Proposal outcome analytics — Analysis of which types of proposals succeed and fail, identifying factors that predict passage: sponsor reputation, proposal quality, category, timing, economic conditions.
• Governance health monitor — Real-time composite governance health scoring across participation rate, power distribution, decision quality, and accountability adherence.
• Power distribution analysis — Power concentration measurement using the Nakamoto coefficient (minimum entities controlling >50% of governance power) and Gini coefficient (inequality measure). Alerts when governance is becoming captured by a small group.
• Intelligence reports — Automated governance intelligence report generation: weekly and monthly summaries of governance activity, trends, health indicators, and emerging risks.

28. Governance Knowledge Base (@themis/knowledge)#

The intellectual foundation of Themis: the world's most comprehensive structured database of governance systems, political theory, and empirical governance research.

• Political systems taxonomy — Complete taxonomy of political systems: liberal democracies, social democracies, Christian democratic systems, authoritarian systems (electoral authoritarian, competitive authoritarian, fully authoritarian), hybrid regimes, and everything between, with empirical examples.
• Government structure models — Presidential systems (US, Ghana, Nigeria), semi-presidential systems (France, Russia), parliamentary systems (UK, Germany, India), and council systems with their variants and known properties.
• Electoral systems encyclopedia — All major electoral systems: First Past the Post (UK, US, Ghana), Proportional Representation variants (party list, Mixed-Member Proportional, Single Transferable Vote), Mixed systems, and their documented properties for representation, accountability, and stability.
• Political philosophy reference — Structured reference covering John Rawls (justice as fairness, veil of ignorance), Robert Nozick (libertarian entitlement theory), Jürgen Habermas (deliberative democracy, communicative rationality), Hannah Arendt (public realm, natality, plurality), and 50+ other political theorists.
• Governance theory evaluation — Comparative evaluation of governance theories against empirical evidence from the V-Dem database, Freedom House ratings, World Governance Indicators, and Polity dataset.
• Democratic transition analysis — Patterns and causes of democratic transitions, backsliding, and consolidation from comparative historical analysis.
• Historical governance timeline — Documented timeline of major governance innovations from the Athenian assembly (507 BC) through Magna Carta (1215), the Glorious Revolution (1688), the US Constitutional Convention (1787), to modern digital democracy experiments.
• Case study library — 200+ structured case studies of governance successes and failures with analysis of causes and replicable lessons.

29. Governance Frameworks Library (@themis/frameworks)#

Complete implementations of major governance frameworks as configurable, composable primitives:

• Direct democracy — Swiss-style direct democracy with initiative (citizens propose laws), referendum (citizens vote on laws passed by parliament), and recall (citizens remove elected officials) mechanisms.
• Representative democracy — Parliamentary and presidential variants with electoral system configuration.
• Liquid democracy — Transitive delegation implementation (see also @themis/voting).
• Sociocracy 3.0 (S3) — Circular organizational structure with consent decision-making (proposals pass unless someone has a principled objection), role definition, and policy governance.
• Holacracy — Holacratic governance with constitution, self-organizing circle structure, role elections, and formal governance meetings.
• Conviction voting — Full conviction voting framework (see also @themis/voting).
• Futarchy — Complete futarchy implementation (see also @themis/decisions).
• Bicameral governance — Two-chamber governance with configurable relationships: equal bicameralism (both chambers have equal power), strong upper chamber, or ceremonial upper chamber.
• Consensus governance — Formal consensus process with stand-asides (I can live with this), objections (I have concerns), blocking concerns (this is a principled objection I cannot stand aside from), and trained facilitation protocols.
• Hybrid framework composer — Compose custom governance frameworks by combining primitives from different models. An organization could adopt conviction voting for funding decisions, quadratic voting for strategic direction, and consent decision-making for policy.

30. Governance Simulation (@themis/simulation)#

• Agent-based simulation — Agent-based governance simulation with heterogeneous simulated participants who have different values, information access levels, communication networks, and strategic orientations.
• Pre-built scenario library — Ready-to-run scenarios: voter apathy leading to minority capture, governance capture by a well-organized faction with modest token holdings, coordination failure on urgent decisions, plutocratic override, information asymmetry exploitation.
• Resilience stress testing — Adversarial condition stress testing: how does the governance system perform when 30% of participants act in bad faith? When a whale accumulates 40% of tokens? When outside actors organize a coordinated governance attack?
• Constitutional design simulation — Simulate constitutional design trade-offs before adoption: does a 67% supermajority requirement make the system stable or paralyzed? Does token-weighted voting lead to plutocracy under realistic token distribution assumptions over time?

31. AI Governance Agents (@themis/ai)#

• Autonomous governance delegate — AI delegate that monitors governance activity and votes on proposals according to a configured set of principles and past positions. Provides effective governance participation for token holders who lack time to follow every proposal in active governance systems.
• Proposal analyst — AI agent for structured proposal analysis: financial impact assessment, risk identification, precedent lookup from prior governance decisions, legal compliance checks, and quality scoring.
• Parliamentary procedure assistant — Real-time guidance on Robert's Rules of Order, Standard Code of Parliamentary Procedure, and other procedural frameworks during meetings, preventing procedural confusion from derailing substantive discussion.
• Governance facilitator — AI meeting and process facilitation: agenda management, time-keeping, motion tracking, synthesis of discussion points, and consensus identification.
• Constitutional advisor — AI constitutional law advisory drawing on the knowledge base to analyze proposed constitutional provisions against comparable provisions in other constitutions and flag potential issues before ratification.

32. Originality Shields (@themis/originality-shields + media shields)#

Themis provides a generated-content originality accept-gate: a way to decide, before content is published, whether it overlaps a prior work and whether that overlap is licensed. The gate is built from six small libraries — @themis/originality-shields (the shared core) plus the five media shields @themis/music-shield, @themis/visual-shield, @themis/text-shield, @themis/video-shield, and @themis/design-shield.

These libraries are deliberately thin. They do not run detection models themselves; they construct an evidence bundle and delegate verdict computation to the @concordia/contracts originality-shield contract. Themis owns the per-media-family configuration, the scan-input shape, and the public-UGC accept-gate mapping.

32.1 How a shield scan works#

A caller submits a scan input describing one upload — its uploadId, creatorAccountId, uploadKind (custom-championship, decal, logo, or music-swap), a SHA-256 content hash, a source URI, a creation timestamp, and zero or more referenceMatches (each a prior-work id, an overlap score in 0–1, and whether that overlap is licensed). Optional license lineages and a reviewer sign-off flag may also be supplied.

@themis/originality-shields builds an OriginalityEvidenceBundle, calls the contract's evaluateShield, and returns a verdict. The contract scores overlaps into confidence bands (inconclusive, low_overlap, medium_overlap, high_overlap, substantial_match, identical) and emits one of seven verdicts. Themis collapses those into a three-value decision:

• passed — clear for distribution, clear with attribution, or licensed.
• review — route to human review, or route to counsel for an unverified licensing chain.
• blocked — unlicensed overlap, or a license is required but still pending.

The public-UGC accept gate passes only when decision is passed; anything else blocks the upload. Each verdict carries the evidence bundle, the highest unlicensed band, the maximum similarity score, blocking reasons, an evidence URI, and the audit event type themis.originality_shield.verdict_recorded.

32.2 Per-media shields#

Each media shield is a wrapper that fixes a media family, the UGC upload kinds it covers, and a default evidence kind:

A shield rejects an upload kind it does not cover. Beyond these five thin accept-gate wrappers, the Phase 74–75 detection libraries in §32.4 add per-media detection engines (including character, motion, 3D, fashion, and environment shields); there is still no game-specific shield library.

32.3 V2 consumer#

V2 lands the public-UGC accept-gate subset through @v2/themis-originality-shields, which composes the five media shields above. Every public UGC accept-gate (custom decals, logos, music swaps, custom championships) blocks unless the required shields return passed.

32.4 Fuller detection (Phases 74–75)#

The thin accept-gate shields above are complemented by the Phase 74–75 detection and operations libraries, which are present in libs/themis/:

• Phase 74 — Music Shield depth. @themis/music-shield carries the per-dimension detection envelope (melodic, harmonic, rhythmic, spectral, lyric, vocal, structural) with compound escalation, legally-grounded thresholds, and an ISRC/ISWC-indexed reference database. Design in docs/domains/themis-music-shield-proposal.md.
• Phase 75 — per-media shields. @themis/3d-shield (architectural-work detection, asset-library deduplication, 3D character recognition), @themis/character-shield, @themis/motion-shield (choreography database, dance-move classification), @themis/fashion-shield, and @themis/environment-shield extend detection to 3D assets, characters, motion/choreography, fashion designs, and environments.
• Operations pipeline. @themis/risk-scoring (composite legal-risk scoring with case-law grounding and compound similarity), @themis/review-pipeline (human review with comparison tools and decision recording; plus @themis/universal-review), @themis/remediation and @themis/universal-remediation (remediation workflows), @themis/model-governance (training-data governance), @themis/cross-media-governance (memorization testing, red-team framework), @themis/watermarking (C2PA content provenance, invisible audio watermarking), @themis/shield-api and @themis/shield-client (platform integration surface), and @themis/shield-analytics (monitoring/analytics). Design in docs/domains/themis-universal-originality-shield-proposal.md.

There is no @themis/likeness library in the codebase. V2 dependency docs describe a forthcoming, not-yet-created @themis/likeness name-image-likeness (NIL) rights ledger, explicitly noted as a new package distinct from @themis/identity (governance identity — DID, eligibility, Sybil resistance). Until that library exists there is no LikenessLicense entity and no themis.license.revoked event; treat the NIL ledger as planned scope owned by this domain. V2-side consent and performer-protection bridges (in the V2 sister-monorepo and the Aphrodite/Kuanyin domains) are consumer safeguards, not the Themis ledger.

33. Cross-Domain Integrations (@themis/integrations)#

• Veritas intelligence pipeline — Veritas journalism data (fact-check results, bias scores, accountability records) fed into Themis governance analytics. Journalists query Themis audit trails; Themis surfaces governance integrity data in the Veritas newsroom.
• Themis-Veritas governance feed — Governance decisions and proposal outcomes published to Veritas as structured data for journalistic coverage of governance activity. Unusual voting patterns or treasury transactions trigger automated Veritas alerts.
• Themis-Aje execution bridge — Execute governance decisions on-chain via the Aje blockchain infrastructure. Constitutional designs from Themis compile to Aje Governor contract configurations; Themis proposal lifecycle triggers Aje on-chain voting contracts; Themis treasury governance executes through Aje multi-sig.
• Aje-Themis data ingestion — On-chain governance data (DAO votes, treasury transactions, delegation events) ingested into Themis for analysis and display alongside off-chain governance data.
• Maat organizational governance — Themis governance frameworks integrated with Maat's portfolio company management: board governance, compliance tracking, and executive decision approval gates.
• Lakshmi fiscal governance — Fiscal-governance bridge (lakshmi-themis-fiscal-governance.ts) connecting Themis treasury and funding governance with Lakshmi finance.
• Iris governance assistant — Iris conversational AI interface for querying governance records, getting governance advice, and interacting with governance processes through natural language.
• Sophia knowledge governance — Sophia knowledge base integration for research-backed governance recommendations drawing on the world's governance literature.
• Metis civic education — Metis educational curriculum integration for civics and governance education content powered by Themis's knowledge base.
• Maya virtual governance — Maya virtual world governance environments using Themis frameworks for in-world community governance and DAO structures for metaverse communities.
• Kuanyin ethics integration — Kuanyin's compassionate moderation philosophy informs Themis dispute resolution processes; Kuanyin's trust scoring enriches Themis reputation systems; Themis governance ethics frameworks feed into Kuanyin's community safety standards.

34. Concordia Dispute Routing (@themis/dispute-resolution)#

@themis/dispute-resolution (TODO Phase 179) is the implemented routing and intake layer between Themis governance disputes and the Concordia mediation substrate. It is a small library — Concordia owns the shared bargaining substrate, Aje owns on-chain settlement, and @themis/arbitration owns the heavyweight arbitration/mediation engines. The boundary exists because Concordia's mediation substrate is shared across many Oshun domains; Themis contributes the governance-specific classification and intake logic, while Concordia contributes the general mediation machinery.

• Dispute routing — routeThemisDispute classifies a dispute into one of nine kinds (proposal_amendment, election_challenge, delegate_misconduct, ip_originality_appeal, moderation_appeal, marketplace_conflict, inter_dao_agreement, standard_amendment, community_council_dispute) and returns a routing decision: whether to send it to Concordia, which operational mode to use, the reviewer queues to involve, and a rationale. Every kind routes to Concordia except standard_amendment.
• V2 dispute flows — Three intake builders: an EU Digital Services Act Statement-of-Reasons builder, a moderation-appeal opener (7-day SLA), and a tournament-result dispute opener. V2 binds these live through @v2/themis-dispute-resolution.

The fuller mediated-amendment workflow expansion (governance compromise-search templates, oversight reporting) remains Phase 179 backlog.

35. Academic-Integrity Adjudication (@themis/academic-integrity)#

@themis/academic-integrity is the Themis adjudication engine for Metis academic-integrity cases. The boundary between Metis and Themis here reflects a general principle: Metis owns the academic experience (courses, assessments, learner journeys), while Themis owns the adjudication mechanics when integrity violations require a governed process with appeals rights and bias monitoring. This library is independent of @themis/core — it depends only on Zod.

• Signal taxonomy — A structured taxonomy of academic-integrity signals.
• Calibrated classifier policy — Classifier policy plus a severity→action map that turns a graded signal into a proportionate action.
• Appeals workflow — A workflow for contesting an adjudication outcome.
• Bias monitor — Monitoring of the classifier for biased outcomes.
• Verdict persistence — Persistence of adjudication verdicts.
• Adjudicator orchestrator — End-to-end orchestration tying the signal intake, classifier, severity mapping, bias monitor, and verdict persistence together.