Initial commit: Platform-agnostic governance bot

Govbot is an AI-powered governance bot that interprets natural language
constitutions and facilitates collective decision-making across social
platforms.

Core features:
- Agentic architecture with constitutional reasoning (RAG)
- Platform-agnostic design (Mastodon, Discord, Telegram, etc.)
- Action primitives for flexible governance processes
- Temporal awareness for multi-day proposals and voting
- Audit trail with constitutional citations
- Reversible actions with supermajority veto
- Works with local (Ollama) and cloud AI models

Platform support:
- Mastodon: Full implementation with streaming, moderation, and admin skills
- Discord/Telegram: Platform abstraction ready for implementation

Documentation:
- README.md: Architecture and overview
- QUICKSTART.md: Getting started guide
- PLATFORMS.md: Platform implementation guide for developers
- MASTODON_SETUP.md: Complete Mastodon deployment guide
- constitution.md: Example governance constitution

Technical stack:
- Python 3.11+
- SQLAlchemy for state management
- llm CLI for model abstraction
- Mastodon.py for Mastodon integration
- Pydantic for configuration validation

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

config/config.example.yaml

@@ -0,0 +1,43 @@
+platform:
+  # Platform type: mastodon, discord, telegram, mock
+  type: mastodon
+
+  # Mastodon configuration (if using Mastodon)
+  mastodon:
+    instance_url: https://your-mastodon-instance.social
+    client_id: your_client_id_here
+    client_secret: your_client_secret_here
+    access_token: your_access_token_here
+    bot_username: govbot
+
+  # Discord configuration (for future use)
+  # discord:
+  #   token: your_discord_bot_token
+  #   guild_id: your_server_id
+
+  # Telegram configuration (for future use)
+  # telegram:
+  #   bot_token: your_telegram_bot_token
+  #   group_id: your_group_id
+
+ai:
+  # Use 'llama3.2' for Ollama local models
+  # Use 'gpt-4' for OpenAI
+  # Use 'claude-3-sonnet' for Anthropic
+  # Or leave as null to use llm default
+  default_model: llama3.2
+  fallback_model: null
+  temperature: 0.7
+  max_tokens: null
+
+governance:
+  constitution_path: constitution.md
+  db_path: govbot.db
+  default_veto_threshold: 0.67  # 2/3 supermajority
+  enable_auto_execution: true
+  require_confirmation_for:
+    - admin_action
+    - moderation
+
+debug: false
+log_level: INFO