Governance Overview

constitution DataGovernance {
    description: "Data processing rules"
    
    laws: [
        {
            name: "Size Limit",
            description: "Data must be under 1000 bytes",
            enforcement: mandatory,  // Blocks violations
            rules: ["data_size < 1000"]
        },
        {
            name: "Temperature Control",
            description: "Temperature must be 0-1",
            enforcement: mandatory,
            rules: ["temperature >= 0", "temperature <= 1"]
        },
        {
            name: "Best Practice",
            description: "Lower temperature recommended",
            enforcement: advisory,  // Warns but allows
            rules: ["temperature <= 0.7"]
        }
    ]
}

law PrivacyLaw {
    name: "Privacy Protection"
    description: "Protect user data"
    enforcement: mandatory
    
    rules: [
        "data_contains_pii == false",  // No personal data
        "encryption_enabled == true"    // Encryption on
    ]
}

// Constitution is now active!
// All agent calls are automatically checked

agent SafeAssistant {
    provider: "openai"
    
    task process(data) {
        // This will be BLOCKED (data too large)
        // let response = this.call({
        //     prompt: "A" * 2000,
        //     temperature: 0.7
        // });
        
        // This works (compliant)
        let response = this.call({
            prompt: "Hello!",
            temperature: 0.5
        });
        
        return response;
    }
}

council SecurityCouncil {
    name: "Security Council"
    constitution: "DataGovernance"
    
    members: [
        {
            agent: "SecurityAgent",
            role: "Judge",      // Evaluates compliance
            permissions: ["evaluate_compliance"]
        },
        {
            agent: "AuditAgent",
            role: "Auditor",    // Keeps records
            permissions: ["audit_log"]
        },
        {
            agent: "ManagerAgent",
            role: "Executor",   // Executes decisions
            permissions: ["execute_decision"]
        }
    ]
}

// Use a built-in type with defaults
governance MyDemocracy: democracy

// Override specific fields
governance StrictMonarchy: monarchy {
    description: "Absolute rule",
    constitution_compliance: 0.95,
}

// Turkish type names also work
governance TurkishConsensus: uzlaşı {
    description: "Consensus-based",
}

// Read values
yaz(MyDemocracy.type)                    // democracy
yaz(MyDemocracy.constitution_compliance) // 0.8
yaz(MyDemocracy.law_flexibility)         // 0.7
yaz(MyDemocracy.rule_enforcement)        // 0.6

governance MyGov: democracy

protocol MeetingProtocol: {
    execution: parallel,       // parallel | sequential | competitive | roundRobin
    governance: MyGov,         // reference to a governance declaration
    timeout: 30,               // seconds

    session: {
        onStart:           fn() { yaz("Council started") },
        onMemberStart:     fn() { yaz("Member speaking") },
        onMemberComplete:  fn() { yaz("Member done") },
        onComplete:        fn() { yaz("All done") },
        onError:           fn() { yaz("Error occurred") },
    }
}

// Use in a council call
let result = MyCouncil.call("What is the best approach?", MeetingProtocol)