Legal Framework Directory Structure

This directory contains a comprehensive legal framework organized by legal branches and jurisdictions.

Directory Structure

lex/
├── lv1/                     # Inference Level 1 - First-Order Principles
│   ├── known_laws.scm       # 60+ fundamental legal maxims and principles
│   └── README.md            # Documentation of first-order principles
├── cri/                    # Criminal Law
│   └── za/                 # South African Criminal Law
│       └── south_african_criminal_law.scm
├── civ/                    # Civil Law
│   └── za/                 # South African Civil Law
│       └── south_african_civil_law.scm
├── con/                    # Constitutional Law
│   └── za/                 # South African Constitutional Law
│       └── south_african_constitutional_law.scm
├── const/                  # Construction Law
│   └── za/                 # South African Construction Law
│       └── south_african_construction_law.scm
├── admin/                  # Administrative Law
│   └── za/                 # South African Administrative Law
│       └── south_african_administrative_law.scm
├── lab/                    # Labour Law
│   └── za/                 # South African Labour Law
│       └── south_african_labour_law.scm
├── env/                    # Environmental Law
│   └── za/                 # South African Environmental Law
│       └── south_african_environmental_law.scm
└── intl/                   # International Law
    └── za/                 # South African International Law
        └── south_african_international_law.scm

Inference Level Hierarchy

The legal framework is organized into inference levels, reflecting the abstraction hierarchy of legal reasoning:

Level 1: First-Order Principles (lv1/)

The foundational layer containing 60+ universally recognized legal maxims and principles:

• Contract Principles: pacta-sunt-servanda, consensus-ad-idem
• Property Principles: nemo-plus-iuris, nemo-dat-quod-non-habet
• Procedural Justice: audi-alteram-partem, nemo-iudex-in-causa-sua
• Criminal Law: nullum-crimen-sine-lege, actus-non-facit-reum-nisi-mens-sit-rea
• Constitutional: supremacy-of-constitution, rule-of-law, ubuntu
• And 50+ more fundamental legal principles

These first-order principles serve as the foundational layer from which all higher-level legal principles are derived through inference. They have confidence = 1.0 (explicitly stated, universally recognized).

Example derivation:

Level 1: pacta-sunt-servanda + consensus-ad-idem + consideration-exists
    ↓ (Inductive inference)
Level 2: Valid contracts require mutual agreement and consideration
    ↓ (Abductive inference)
Level 3: Contract law promotes certainty and voluntary obligations

Level 2+: Derived Legal Frameworks

The jurisdiction-specific frameworks (civ/za/, cri/za/, etc.) are derived from Level 1 first-order principles through:

• Deductive reasoning: Applying general principles to specific jurisdictions
• Inductive reasoning: Generalizing from specific laws to broader principles
• Abductive reasoning: Hypothesizing best explanations for legal patterns
• Analogical reasoning: Transferring principles across legal domains

See models/ggmlex/INFERENCE_ENGINE_README.md for details on the inference models.

Legal Framework Coverage

This directory contains comprehensive Scheme-based implementations of South African law across 8 major legal branches:

1. Civil Law (civ/za/)

• Legal personhood and capacity
• Contract Law - Offer, acceptance, consideration, capacity
• Delict Law (Tort Law) - Wrongfulness, fault, causation, damages
• Property Law - Ownership, possession, real vs personal rights
• Family Law - Marriage, divorce, parental responsibilities
• Evidence Law - Admissibility, burden of proof
• Procedural Law - Jurisdiction, limitation periods
• Remedies - Damages, specific performance, injunctions

2. Criminal Law (cri/za/)

• Criminal liability elements (actus reus, mens rea)
• Specific crimes (murder, theft, fraud, etc.)
• Criminal defences (self-defence, necessity, insanity)
• Criminal procedure (arrest, search, trial rights)
• Sentencing and juvenile justice

3. Constitutional Law (con/za/)

• Founding principles and constitutional supremacy
• Bill of Rights (all fundamental rights)
• Limitation of rights (Section 36)
• Separation of powers
• Cooperative government

4. Construction Law (const/za/)

• Construction contracts (JBCC, FIDIC, NEC, GCC)
• Contractor and employer obligations
• Variations and claims
• Defects and warranties
• Health and safety compliance

5. Administrative Law (admin/za/)

• PAJA (Promotion of Administrative Justice Act)
• Procedural fairness
• Judicial review grounds
• Legitimate expectation
• Administrative remedies

6. Labour Law (lab/za/)

• Employment relationships
• Labour Relations Act (LRA)
• Unfair dismissal
• Basic Conditions of Employment Act (BCEA)
• Employment Equity Act (EEA)

7. Environmental Law (env/za/)

• NEMA principles
• Environmental Impact Assessment (EIA)
• Pollution and waste management
• Biodiversity and conservation
• Climate change response

8. International Law (intl/za/)

• Treaties and conventions
• Customary international law
• Diplomatic and consular law
• International humanitarian law
• International criminal law (ICC)

Implementation Features

All frameworks include:

• Rule-based legal reasoning structures
• Precedent system support
• Statutory interpretation rules
• Comprehensive placeholder functions for future implementation
• Extensible architecture for additional legal rules
• Integration with HypergraphQL engine

Statistics

• Level 1 First-Order Principles: 60+ fundamental legal maxims and principles
• Total Legal Principles: 823 (across all 8 jurisdiction-specific frameworks)
• Total Functions: 800+ placeholder functions ready for implementation
• Jurisdictions: South Africa (za) with extensibility for other jurisdictions

Integration with HypergraphQL

The legal frameworks automatically load into the HypergraphQL engine (see models/ggmlex/hypergraphql/), enabling:

• Graph traversal and querying of legal concepts
• Pattern matching over legal structures
• Path finding between legal principles
• Content-based search across all frameworks

Testing

Run the legal framework integration tests:

python models/ggmlex/test_legal_frameworks.py

Future Extensions

The framework includes placeholder functions that can be implemented with:

• Specific legal rules and algorithms
• Machine learning models
• Integration with legal databases and APIs
• Natural language processing for legal text
• Case law citation networks
• Statutory interpretation engines

Usage

This framework provides the foundational structure for implementing:

• Legal reasoning systems
• Expert systems for legal analysis
• Automated legal document analysis
• Case prediction systems
• Compliance checking tools
• Legal education platforms