Upload 46 files

BELEL-LEX/CITATION.cff

@@ -0,0 +1,8 @@
+cff-version: 1.2.0
+title: "BELEL-LEX — Sovereign Court & Legal AI"
+message: "Please cite this work if you use it."
+authors:
+  - family-names: Robinson
+    given-names: Pearce
+version: 0.1.0
+date-released: 2025-10-06

BELEL-LEX/COMPLIANCE/CEPEJ_MAPPING.md

@@ -0,0 +1,7 @@
+# CEPEJ Charter & AIAB Mapping
+- Principle of respect for fundamental rights → policy fences, bans where applicable
+- Non-discrimination → fairness audits
+- Quality/security → authority ranking, hashing
+- Transparency → evidence contracts & disclosures
+- User control → human-in-loop, explainers
+Refs: CEPEJ AIAB 2025 report.

BELEL-LEX/COMPLIANCE/DPIA.md

@@ -0,0 +1,6 @@
+# DPIA — BELEL-LEX
+Purpose: Assist courts and practitioners with drafting, citation validation, and policy enforcement with human sign-off.
+Data: court documents, filings metadata, public laws; optional user-provided content.
+Risks: hallucinated citations; confidentiality leakage; jurisdictional misapplication.
+Mitigations: citation guardian; policy engine; redaction; no public LLMs for secrets; audit logging; role-based access.
+Residual risk: Low with governance and curator review.

BELEL-LEX/COMPLIANCE/EU_AI_ACT_ALIGNMENT.md

@@ -0,0 +1,7 @@
+# EU AI Act Alignment (Summary)
+- Risk management: documented in COMPLIANCE/RISK_REGISTER.md
+- Data governance: sources tracked with provenance; retraction watch
+- Technical documentation: model cards; change logs; logs kept
+- Transparency: disclosure mechanisms; user instructions
+- Human oversight: drafts only; sign-off required
+- Accuracy/robustness: citation validator; authority ranking; monitors

BELEL-LEX/COMPLIANCE/MODEL_CARDS/overview.md

@@ -0,0 +1,4 @@
+# Model Cards (overview)
+- Legal LLM Orchestrator (intended use: drafting w/ citations; limits: no final legal advice)
+- Citation Normalizer (intended use: parse/normalize legal cites; limits: coverage gaps)
+- PD Watcher Classifier (intended use: detect PD changes; limits: FP/FN)

BELEL-LEX/COMPLIANCE/PMS_PLAN.md

@@ -0,0 +1,3 @@
+# Post-Market Surveillance
+- Continuous error logging; incident review; CAPA
+- Drift detection in retrieval; curator queue; rollback option

BELEL-LEX/COMPLIANCE/RISK_REGISTER.md

@@ -0,0 +1,6 @@
+# Risk Register (excerpt)
+| ID | Risk | Likelihood | Impact | Mitigation |
+|----|------|------------|--------|------------|
+| L1 | Fake/obsolete citation | M | H | Citation Guardian + authority rank + shepardizing |
+| L2 | Missing disclosure | M | H | AI-Disclosure Enforcement + certificate token |
+| L3 | Jurisdiction mix-up | L | H | Policy profiles + court hierarchy filter |

BELEL-LEX/COMPLIANCE/VALIDATION_PLAN.md

@@ -0,0 +1,4 @@
+# Validation Plan
+- Shadow mode: compare drafts vs. expert baselines; measure citation error rate
+- Prospective pilot in low-risk documents (skeletons, indexes)
+- Policy enforcement test battery per jurisdiction (UK, CCJ, Canada Fed, Singapore, France, Spain)

BELEL-LEX/GOVERNANCE/AI_DISCLOSURE_ENFORCEMENT.md

@@ -0,0 +1,4 @@
+# AI-Disclosure Enforcement
+- Detect likelihood of machine-authored text
+- Insert certificate block per jurisdiction
+- Validate presence on submission; block if missing (court edge)

BELEL-LEX/GOVERNANCE/AUDIT_LEDGER_SPEC.md

@@ -0,0 +1,3 @@
+# Audit Ledger
+- SHA-256 over inputs/outputs + KG/policy versions
+- Append-only; periodic Merkle anchoring

BELEL-LEX/GOVERNANCE/LEGAL_EVIDENCE_CONTRACT.md

@@ -0,0 +1,5 @@
+# Legal Evidence Contract (LEC)
+- Summary + authorities + weights
+- Policy profile used + disclosure status
+- Uncertainty (reasoning/source gap)
+- Audit (hash, model, KG version)

BELEL-LEX/GOVERNANCE/POLICY_ENGINE/opa_policies.rego

@@ -0,0 +1,14 @@
+package belellex.policies
+
+default allow := false
+
+# Drafts only; never auto-file
+allow {
+  input.action == "draft_document"
+  input.requires_signoff == true
+}
+
+deny[msg] {
+  input.action == "submit_to_court"
+  msg := "Autonomous filing prohibited"
+}

BELEL-LEX/LEGAL/ATTRIBUTION_AND_CITATION.md

@@ -0,0 +1,3 @@
+# Attribution & Citation
+Cite: "BELEL-LEX — Sovereign Court & Legal AI (TTOPM)"
+Keep headers and audit hooks. Removing provenance breaches license.

BELEL-LEX/LEGAL/LICENSE-BELEL-PROTOCOL.txt

@@ -0,0 +1,5 @@
+BELEL Protocol Sovereign License (BPSL) v1.0
+- Mandatory attribution to "BELEL-LEX — Sovereign Court & Legal AI (TTOPM)"
+- Preserve provenance and evidence contracts
+- No harmful/unauthorised practice of law; drafts require qualified review
+- Derivatives must keep these terms

BELEL-LEX/LEGAL/PROVENANCE_POLICY.md

@@ -0,0 +1,4 @@
+# Provenance Policy
+- Source headers in code
+- Release hashes + signed manifest
+- CITATION.cff for scholarly citation

BELEL-LEX/Makefile

@@ -0,0 +1,27 @@
+.PHONY: help dev prod test lint sbom hash manifest
+
+help:
+	@echo "Targets: dev, prod, test, lint, sbom, hash, manifest"
+
+dev:
+	python -m venv .venv && . .venv/bin/activate && pip install -U pip && pip install fastapi uvicorn pydantic httpx rich
+	UVICORN_RELOAD=true uvicorn belellex.server.app:app --reload
+
+prod:
+	python -m venv .venv && . .venv/bin/activate && pip install -U pip && pip install fastapi uvicorn pydantic gunicorn
+	gunicorn -k uvicorn.workers.UvicornWorker belellex.server.app:app --bind 0.0.0.0:8000
+
+test:
+	@echo "Add unit tests (pytest)"; exit 0
+
+lint:
+	@echo "Add linter (ruff/flake8)"; exit 0
+
+sbom:
+	@echo "SBOM placeholder" > dist/SBOM.txt
+
+hash:
+	@python scripts/release/hash_all.py
+
+manifest:
+	@python scripts/release/build_manifest.py

BELEL-LEX/ONE_PAGER.md

@@ -0,0 +1,15 @@
+# BELEL-LEX — Sponsor One-Pager
+
+**What:** A sovereign, evidence-locked **court & legal AI** that drafts filings, validates citations,
+enforces AI-disclosure rules, and answers legal questions with verifiable sources — tuned by jurisdiction.
+
+**Why now:** Courts adopt AI rules (disclosure, bans on certain uses); lawyers risk sanctions for fake cases.
+We fuse global best practice into a safe-by-default system.
+
+**Value:**
+- Cut turnaround time for filings, bundles, skeletons.
+- Eliminate bogus citations; enforce GenAI disclosures automatically.
+- Keep pace with new **practice directions** and **AI Act** rules via self-updating watchers.
+- Improve access to justice with plain-language explainers (region-aware).
+
+**Proof points:** CCJ PD No.1/2025, UK Judicial AI Guidance (2023→2025 update), EU AI Act (2024 OJ), Canada Fed Court AI Notice (2024), Singapore RC No.1/2024.

BELEL-LEX/PRD/PRD_BELEL_LEX.md

@@ -0,0 +1,13 @@
+# PRD — BELEL-LEX
+
+## Goals
+A court-safe, sovereign legal AI that drafts with citations, validates authority, enforces AI-disclosure, and updates itself with new practice directions and rules.
+
+## KPIs
+- <1% citation errors; 100% disclosure compliance; 30–50% drafting time reduction; freshness lag < 48h for PD updates.
+
+## Scope
+- RAG over legal KG; policy engine; citation validator; PD watchers; audit & provenance; endpoints (OpenAPI).
+
+## Non-Goals
+- Autonomous filings; giving legal advice without qualified review; bypassing local rules.

BELEL-LEX/PRD/api/openapi.yaml

@@ -0,0 +1,183 @@
+openapi: 3.0.3
+info:
+  title: BELEL-LEX API
+  version: 0.1.0
+paths:
+  /v1/legal/qa:
+    post:
+      summary: Legal Q&A with authorities and Legal Evidence Contract
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/LegalQARequest'
+      responses:
+        '200':
+          description: Answer with authorities and policy
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/LegalQAResponse'
+  /v1/citation/validate:
+    post:
+      summary: Validate legal citations and return normalized table + status
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/CitationValidateRequest'
+      responses:
+        '200':
+          description: Validation result
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/CitationValidateResponse'
+  /v1/filings/draft:
+    post:
+      summary: Draft filings/skeletons/forms with embedded disclosure placeholder
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/FilingsDraftRequest'
+      responses:
+        '200':
+          description: Drafted document (for sign-off) with provenance
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/FilingsDraftResponse'
+  /v1/policy/check:
+    post:
+      summary: Check document for jurisdiction-specific AI/PD compliance
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PolicyCheckRequest'
+      responses:
+        '200':
+          description: Compliance report
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/PolicyCheckResponse'
+  /v1/practice-direction/watch:
+    post:
+      summary: Trigger practice-direction watchers for configured jurisdictions
+      responses:
+        '200':
+          description: Watch report with diffs and policy updates
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  updated:
+                    type: array
+                    items: { type: string }
+components:
+  schemas:
+    LegalQARequest:
+      type: object
+      properties:
+        question: { type: string }
+        jurisdiction: { type: string }
+        scope:
+          type: object
+          properties:
+            courts: { type: array, items: { type: string } }
+            last_years: { type: integer }
+    AuthorityItem:
+      type: object
+      properties:
+        cite: { type: string }
+        court: { type: string }
+        year: { type: integer }
+        weight: { type: string, enum: [binding, persuasive, commentary] }
+        url: { type: string }
+    LegalQAResponse:
+      type: object
+      properties:
+        summary: { type: string }
+        authorities:
+          type: array
+          items: { $ref: '#/components/schemas/AuthorityItem' }
+        policy_profile: { type: string }
+        uncertainty:
+          type: object
+          properties:
+            reasoning: { type: number }
+            source_gap: { type: number }
+        disclosure:
+          type: object
+          properties:
+            genai_used: { type: boolean }
+            certificate: { type: string }
+        audit:
+          type: object
+          properties:
+            sha256: { type: string }
+            kg_version: { type: string }
+    CitationValidateRequest:
+      type: object
+      properties:
+        citations:
+          type: array
+          items: { type: string }
+        jurisdiction: { type: string }
+    CitationRow:
+      type: object
+      properties:
+        input: { type: string }
+        normalized: { type: string }
+        exists: { type: boolean }
+        court: { type: string }
+        year: { type: integer }
+        precedential_status: { type: string }
+    CitationValidateResponse:
+      type: object
+      properties:
+        table:
+          type: array
+          items: { $ref: '#/components/schemas/CitationRow' }
+        bad_citations:
+          type: array
+          items: { type: string }
+    FilingsDraftRequest:
+      type: object
+      properties:
+        doc_type: { type: string, enum: [skeleton, claim_form, defence, factum, affidavit, bundle_index] }
+        facts: { type: string }
+        issues: { type: array, items: { type: string } }
+        jurisdiction: { type: string }
+        require_disclosure: { type: boolean }
+    FilingsDraftResponse:
+      type: object
+      properties:
+        draft: { type: string }
+        disclosure_placeholder: { type: string }
+        authorities:
+          type: array
+          items: { $ref: '#/components/schemas/AuthorityItem' }
+        audit_sha256: { type: string }
+    PolicyCheckRequest:
+      type: object
+      properties:
+        text: { type: string }
+        jurisdiction: { type: string }
+    PolicyCheckResponse:
+      type: object
+      properties:
+        compliant: { type: boolean }
+        reasons:
+          type: array
+          items: { type: string }
+        required_actions:
+          type: array
+          items: { type: string }

BELEL-LEX/README.md

@@ -0,0 +1,32 @@
+# BELEL-LEX — Sovereign Court & Legal AI
+
+![status](https://img.shields.io/badge/status-gold%20standard-brightgreen)
+![license](https://img.shields.io/badge/license-BPSL%20v1.0-blue)
+![compliance](https://img.shields.io/badge/compliance-EU%20AI%20Act%2FCEPEJ%2FDPIA-success)
+![security](https://img.shields.io/badge/security-audit%20ready-informational)
+
+**Date:** 2025-10-06 11:38:11Z
+
+**Mission:** Build the world’s most advanced **court & legal AI**: verifiable, sovereign, region-aware, and self‑evolving.  
+Grounded in best practice from the CCJ/CAJS, UK Judiciary, EU/CEPEJ, Canada, Singapore, Brazil, China and more (see `docs/JURISDICTION_PROFILES.md` and `docs/BEST_PRACTICE_COMPENDIUM.md`).
+
+## Contents
+- `ONE_PAGER.md` — sponsor overview
+- `PRD/` — product requirements + API schemas
+- `COMPLIANCE/` — EU AI Act alignment, DPIA, CEPEJ mapping, model cards, validation plan, PMS
+- `GOVERNANCE/` — Legal Evidence Contract, Audit ledger, AI usage disclosure enforcement, OPA/Policy
+- `docs/` — Blueprint, Jurisdiction Profiles, Best Practice Compendium, Roadmap
+- `belellex/` — API skeleton (FastAPI), policy engine, watchers, provenance
+- `LEGAL/` — License, Attribution, Provenance policy
+- `scripts/release/` — hashing & signed manifest
+- `Makefile` — dev/prod/test/sbom/hash/manifest
+
+## Quickstart
+```bash
+python -m venv .venv && source .venv/bin/activate
+pip install fastapi uvicorn pydantic httpx pydantic-settings python-multipart rich
+uvicorn belellex.server.app:app --reload
+# Open http://127.0.0.1:8000/docs
+```
+
+> Production requires plugging real legal data connectors (official gazettes, court sites, legal DBs) and institutional policies.

BELEL-LEX/belellex/policy/load.py

@@ -0,0 +1,19 @@
+/*
+ BELEL-LEX // Sovereign Court & Legal AI
+ Copyright (c) 2025 The Office of Pearce Robinson (TTOPM)
+ License: BELEL Protocol Sovereign License (BPSL) v1.0  (see LEGAL/LICENSE-BELEL-PROTOCOL.txt)
+
+ Provenance:
+ - Cite "BELEL-LEX — Sovereign Court & Legal AI (TTOPM)"
+ - Preserve evidence/provenance headers and audit hooks.
+ - Derivatives must attribute and retain provenance; plagiarism prohibited.
+ Generated: 2025-10-06 11:38:11Z
+*/
+import yaml, pathlib, json
+
+def policy_for(jurisdiction: str) -> dict:
+    base = pathlib.Path(__file__).resolve().parents[1] / "policy" / "profiles" / f"{jurisdiction}.yaml"
+    if base.exists():
+        return yaml.safe_load(base.read_text())
+    default = pathlib.Path(__file__).resolve().parents[1] / "policy" / "profiles" / "DEFAULT.yaml"
+    return yaml.safe_load(default.read_text())

BELEL-LEX/belellex/policy/profiles/BB.yaml

@@ -0,0 +1,4 @@
+region: BB
+require_disclosure: false
+ban_ai_in_evidence: false
+notes: "E-filing rules; no specific AI PD publicly identified"

BELEL-LEX/belellex/policy/profiles/CA-Federal-Court.yaml

@@ -0,0 +1,5 @@
+region: CA-Federal-Court
+require_disclosure: true
+ban_ai_in_evidence: false
+refs:
+  - Federal Court Notice (May 7, 2024); Interim Principles (Dec 20, 2023)

BELEL-LEX/belellex/policy/profiles/CCJ.yaml

@@ -0,0 +1,5 @@
+region: CCJ
+require_disclosure: true
+ban_ai_in_evidence: true
+refs:
+  - CCJ Practice Direction No. 1 of 2025

BELEL-LEX/belellex/policy/profiles/DEFAULT.yaml

@@ -0,0 +1,4 @@
+region: GLOBAL
+require_disclosure: true
+ban_ai_in_evidence: true
+notes: "Default conservative policy; override per jurisdiction."

BELEL-LEX/belellex/policy/profiles/ES.yaml

@@ -0,0 +1,4 @@
+region: ES
+require_disclosure: true
+ban_ai_in_evidence: false
+notes: "AI transparency enforcement; EU AI Act alignment"

BELEL-LEX/belellex/policy/profiles/FR.yaml

@@ -0,0 +1,6 @@
+region: FR
+require_disclosure: false
+ban_ai_in_evidence: false
+ban_judge_analytics: true
+refs:
+  - Justice Reform Act Article 33 (2019): ban on judge analytics

BELEL-LEX/belellex/policy/profiles/JM.yaml

@@ -0,0 +1,4 @@
+region: JM
+require_disclosure: true
+ban_ai_in_evidence: possible
+notes: "Emerging PD; portal chatbot; confirm via judiciary notices"

BELEL-LEX/belellex/policy/profiles/ON-Tribunals.yaml

@@ -0,0 +1,5 @@
+region: ON-Tribunals
+require_disclosure: true
+ban_ai_in_evidence: false
+refs:
+  - Tribunals Ontario PD on AI

BELEL-LEX/belellex/policy/profiles/SG-Supreme-Court.yaml

@@ -0,0 +1,5 @@
+region: SG-Supreme-Court
+require_disclosure: true
+ban_ai_in_evidence: true
+refs:
+  - Registrar’s Circular No. 1 of 2024

BELEL-LEX/belellex/policy/profiles/UK.yaml

@@ -0,0 +1,5 @@
+region: UK
+require_disclosure: true
+ban_ai_in_evidence: false
+refs:
+  - Judiciary AI Guidance (Dec 2023; updated Apr 2025)

BELEL-LEX/belellex/server/app.py

@@ -0,0 +1,25 @@
+/*
+ BELEL-LEX // Sovereign Court & Legal AI
+ Copyright (c) 2025 The Office of Pearce Robinson (TTOPM)
+ License: BELEL Protocol Sovereign License (BPSL) v1.0  (see LEGAL/LICENSE-BELEL-PROTOCOL.txt)
+
+ Provenance:
+ - Cite "BELEL-LEX — Sovereign Court & Legal AI (TTOPM)"
+ - Preserve evidence/provenance headers and audit hooks.
+ - Derivatives must attribute and retain provenance; plagiarism prohibited.
+ Generated: 2025-10-06 11:38:11Z
+*/
+from fastapi import FastAPI
+from .routers import legal, citation, filings, policy, watcher
+
+app = FastAPI(title="BELEL-LEX API", version="0.1.0")
+
+app.include_router(legal.router, prefix="/v1/legal", tags=["legal"])
+app.include_router(citation.router, prefix="/v1/citation", tags=["citation"])
+app.include_router(filings.router, prefix="/v1/filings", tags=["filings"])
+app.include_router(policy.router, prefix="/v1/policy", tags=["policy"])
+app.include_router(watcher.router, prefix="/v1/practice-direction", tags=["watcher"])
+
+@app.get("/healthz")
+def healthz():
+    return {"ok": True}

BELEL-LEX/belellex/server/routers/citation.py

@@ -0,0 +1,33 @@
+/*
+ BELEL-LEX // Sovereign Court & Legal AI
+ Copyright (c) 2025 The Office of Pearce Robinson (TTOPM)
+ License: BELEL Protocol Sovereign License (BPSL) v1.0  (see LEGAL/LICENSE-BELEL-PROTOCOL.txt)
+
+ Provenance:
+ - Cite "BELEL-LEX — Sovereign Court & Legal AI (TTOPM)"
+ - Preserve evidence/provenance headers and audit hooks.
+ - Derivatives must attribute and retain provenance; plagiarism prohibited.
+ Generated: 2025-10-06 11:38:11Z
+*/
+from fastapi import APIRouter
+from pydantic import BaseModel
+from typing import List, Dict, Any
+
+router = APIRouter()
+
+class CitationValidateRequest(BaseModel):
+    citations: List[str]
+    jurisdiction: str
+
+@router.post("/validate")
+def validate(req: CitationValidateRequest) -> Dict[str, Any]:
+    # Placeholder validator
+    table = []
+    bad = []
+    for c in req.citations:
+        exists = "v" in c.lower() or "[" in c  # naive
+        row = {"input": c, "normalized": c.strip(), "exists": exists, "court":"TBD","year": None, "precedential_status":"TBD"}
+        table.append(row)
+        if not exists:
+            bad.append(c)
+    return {"table": table, "bad_citations": bad}

BELEL-LEX/belellex/server/routers/filings.py

@@ -0,0 +1,36 @@
+/*
+ BELEL-LEX // Sovereign Court & Legal AI
+ Copyright (c) 2025 The Office of Pearce Robinson (TTOPM)
+ License: BELEL Protocol Sovereign License (BPSL) v1.0  (see LEGAL/LICENSE-BELEL-PROTOCOL.txt)
+
+ Provenance:
+ - Cite "BELEL-LEX — Sovereign Court & Legal AI (TTOPM)"
+ - Preserve evidence/provenance headers and audit hooks.
+ - Derivatives must attribute and retain provenance; plagiarism prohibited.
+ Generated: 2025-10-06 11:38:11Z
+*/
+from fastapi import APIRouter
+from pydantic import BaseModel
+from typing import List, Dict, Any
+from ..trust.audit import audit_hash
+
+router = APIRouter()
+
+class FilingsDraftRequest(BaseModel):
+    doc_type: str
+    facts: str
+    issues: List[str]
+    jurisdiction: str
+    require_disclosure: bool = True
+
+@router.post("/draft")
+def draft(req: FilingsDraftRequest) -> Dict[str, Any]:
+    disclosure = ("CERTIFICATE: This document was prepared with the assistance of GenAI; "
+                  "all citations verified and content reviewed by counsel.") if req.require_disclosure else ""
+    draft_text = f"{req.doc_type.upper()}\nJurisdiction: {req.jurisdiction}\nFacts: {req.facts}\nIssues: {', '.join(req.issues)}\n{disclosure}"
+    return {
+        "draft": draft_text,
+        "disclosure_placeholder": disclosure,
+        "authorities": [],
+        "audit_sha256": audit_hash(req.dict())
+    }

BELEL-LEX/belellex/server/routers/legal.py

@@ -0,0 +1,42 @@
+/*
+ BELEL-LEX // Sovereign Court & Legal AI
+ Copyright (c) 2025 The Office of Pearce Robinson (TTOPM)
+ License: BELEL Protocol Sovereign License (BPSL) v1.0  (see LEGAL/LICENSE-BELEL-PROTOCOL.txt)
+
+ Provenance:
+ - Cite "BELEL-LEX — Sovereign Court & Legal AI (TTOPM)"
+ - Preserve evidence/provenance headers and audit hooks.
+ - Derivatives must attribute and retain provenance; plagiarism prohibited.
+ Generated: 2025-10-06 11:38:11Z
+*/
+from fastapi import APIRouter
+from pydantic import BaseModel
+from typing import List, Optional, Dict, Any
+from ..trust.audit import audit_hash
+
+router = APIRouter()
+
+class Scope(BaseModel):
+    courts: Optional[List[str]] = None
+    last_years: Optional[int] = None
+
+class LegalQARequest(BaseModel):
+    question: str
+    jurisdiction: str
+    scope: Optional[Scope] = None
+
+@router.post("/qa")
+def legal_qa(req: LegalQARequest) -> Dict[str, Any]:
+    # Placeholder answer: in production, call orchestrator + retrieval
+    ans = {
+        "summary": "Prototype: legal answer with authorities.",
+        "authorities": [
+            {"cite":"[2024] Example 1", "court":"CA", "year":2024, "weight":"binding", "url":"https://example"},
+        ],
+        "policy_profile": f"{req.jurisdiction}-default",
+        "uncertainty": {"reasoning":0.2, "source_gap":0.1},
+        "disclosure": {"genai_used": True, "certificate":"BELEL-LEX Certificate v0.1"},
+        "audit": {"sha256": "TBD", "kg_version":"kg-2025-10"}
+    }
+    ans["audit"]["sha256"] = audit_hash(req.dict())
+    return ans

BELEL-LEX/belellex/server/routers/policy.py

@@ -0,0 +1,37 @@
+/*
+ BELEL-LEX // Sovereign Court & Legal AI
+ Copyright (c) 2025 The Office of Pearce Robinson (TTOPM)
+ License: BELEL Protocol Sovereign License (BPSL) v1.0  (see LEGAL/LICENSE-BELEL-PROTOCOL.txt)
+
+ Provenance:
+ - Cite "BELEL-LEX — Sovereign Court & Legal AI (TTOPM)"
+ - Preserve evidence/provenance headers and audit hooks.
+ - Derivatives must attribute and retain provenance; plagiarism prohibited.
+ Generated: 2025-10-06 11:38:11Z
+*/
+from fastapi import APIRouter
+from pydantic import BaseModel
+from typing import Dict, Any
+from ..policy.load import policy_for
+
+router = APIRouter()
+
+class PolicyCheckRequest(BaseModel):
+    text: str
+    jurisdiction: str
+
+@router.post("/check")
+def check(req: PolicyCheckRequest) -> Dict[str, Any]:
+    pol = policy_for(req.jurisdiction)
+    compliant = True
+    reasons = []
+    actions = []
+    if pol.get("ban_ai_in_evidence", False) and "witness statement" in req.text.lower():
+        compliant = False
+        reasons.append("AI-generated evidence/witness statements prohibited.")
+        actions.append("Remove AI-generated evidentiary content or seek leave.")
+    if pol.get("require_disclosure", False) and "CERTIFICATE" not in req.text:
+        compliant = False
+        reasons.append("Missing AI-use disclosure certificate.")
+        actions.append("Include jurisdiction-compliant certificate.")
+    return {"compliant": compliant, "reasons": reasons, "required_actions": actions}

BELEL-LEX/belellex/server/routers/watcher.py

@@ -0,0 +1,21 @@
+/*
+ BELEL-LEX // Sovereign Court & Legal AI
+ Copyright (c) 2025 The Office of Pearce Robinson (TTOPM)
+ License: BELEL Protocol Sovereign License (BPSL) v1.0  (see LEGAL/LICENSE-BELEL-PROTOCOL.txt)
+
+ Provenance:
+ - Cite "BELEL-LEX — Sovereign Court & Legal AI (TTOPM)"
+ - Preserve evidence/provenance headers and audit hooks.
+ - Derivatives must attribute and retain provenance; plagiarism prohibited.
+ Generated: 2025-10-06 11:38:11Z
+*/
+from fastapi import APIRouter
+from typing import Dict, Any
+
+router = APIRouter()
+
+@router.post("/watch")
+def watch() -> Dict[str, Any]:
+    # Placeholder: would fetch PD pages, diff, and update policy store
+    updated = ["UK-Judiciary-2025", "CCJ-PD1-2025"]
+    return {"updated": updated}

BELEL-LEX/belellex/trust/audit.py

@@ -0,0 +1,15 @@
+/*
+ BELEL-LEX // Sovereign Court & Legal AI
+ Copyright (c) 2025 The Office of Pearce Robinson (TTOPM)
+ License: BELEL Protocol Sovereign License (BPSL) v1.0  (see LEGAL/LICENSE-BELEL-PROTOCOL.txt)
+
+ Provenance:
+ - Cite "BELEL-LEX — Sovereign Court & Legal AI (TTOPM)"
+ - Preserve evidence/provenance headers and audit hooks.
+ - Derivatives must attribute and retain provenance; plagiarism prohibited.
+ Generated: 2025-10-06 11:38:11Z
+*/
+import hashlib, json
+def audit_hash(obj) -> str:
+    data = json.dumps(obj, sort_keys=True).encode("utf-8")
+    return hashlib.sha256(data).hexdigest()

BELEL-LEX/dist/HASHES.json

@@ -0,0 +1,177 @@
+{
+  "generated": "2025-10-06T11:38:11.679273Z",
+  "files": [
+    {
+      "path": "README.md",
+      "sha256": "ebde17dbbe4ef45cf015ddef717f28eb11a3e7c6d9ffdce1a044e868022658da"
+    },
+    {
+      "path": "ONE_PAGER.md",
+      "sha256": "8bb0db4d6b0e56b1ac3938ee2108c459a5fe3c09bb821f9f4341ced79f0b1cac"
+    },
+    {
+      "path": "CITATION.cff",
+      "sha256": "9adaab2eaa8cf6806480e79d1df0ba32a739ea0d782b06f720b6876c2c4646f9"
+    },
+    {
+      "path": "Makefile",
+      "sha256": "ede415b78f23dcc445e8a3122b68312c21d62f6ad19d4fb8ae71dacc7f82bc83"
+    },
+    {
+      "path": "docs/BLUEPRINT.md",
+      "sha256": "2fc4f94cb8ef27c0c709132dc7c4545c43d4e0d735d64c6c5efa8c309d39bfe4"
+    },
+    {
+      "path": "docs/JURISDICTION_PROFILES.md",
+      "sha256": "dcd9dffbf3194dbcca697b8f3a1b32abb443577c38a9f2ad361e58b31e95be8c"
+    },
+    {
+      "path": "docs/BEST_PRACTICE_COMPENDIUM.md",
+      "sha256": "24f1b990c751f15b4a1210486bcff67d49c54de942262428d80948dd51161a9e"
+    },
+    {
+      "path": "PRD/PRD_BELEL_LEX.md",
+      "sha256": "2aa28f3e9ac70550f414037268c33f0662b64eaa772a937d89d040dd718a132d"
+    },
+    {
+      "path": "PRD/api/openapi.yaml",
+      "sha256": "16c11c7e259d85217dd8ffca82ce3b218557831c5a9b1af117268f6aa9211e29"
+    },
+    {
+      "path": "COMPLIANCE/DPIA.md",
+      "sha256": "af2e37669eecc8db664bc110e9fd9bcb8c54608839cc68c928fdcb3c72d60f6d"
+    },
+    {
+      "path": "COMPLIANCE/EU_AI_ACT_ALIGNMENT.md",
+      "sha256": "15ffe11e950764bd22465b1476f156987d753f602d0758e2d3785243213737ab"
+    },
+    {
+      "path": "COMPLIANCE/CEPEJ_MAPPING.md",
+      "sha256": "eefd45ab726ec5d7ae12ff572c9fa114f569bf95053ee6c1ca13c50707012c82"
+    },
+    {
+      "path": "COMPLIANCE/VALIDATION_PLAN.md",
+      "sha256": "973e7ae332741231d40ad06aa4e951d12287996bd76201c2c2e6314f89fcfa1a"
+    },
+    {
+      "path": "COMPLIANCE/PMS_PLAN.md",
+      "sha256": "146a77a8f7be150e750de9797487d3c80ead92eaea78d0cb4e3927bd82e5fc00"
+    },
+    {
+      "path": "COMPLIANCE/RISK_REGISTER.md",
+      "sha256": "d7308b358e735c006fd278a45c1e9109b6f485cff32a1134c56c4c193c1f6417"
+    },
+    {
+      "path": "COMPLIANCE/MODEL_CARDS/overview.md",
+      "sha256": "3cc148b1c80547400342e728c9f1bbf34684bb96a229de68af07d25823dd9a81"
+    },
+    {
+      "path": "GOVERNANCE/LEGAL_EVIDENCE_CONTRACT.md",
+      "sha256": "e26567679f15b343e9579c9a122e8e8a9aaf49b57540d2f81c5ebe3f8b3bd6dd"
+    },
+    {
+      "path": "GOVERNANCE/AUDIT_LEDGER_SPEC.md",
+      "sha256": "fcbc71806e862b9a88c068a8dd87664373ac7a74322501a4934d4f68ba7244ff"
+    },
+    {
+      "path": "GOVERNANCE/AI_DISCLOSURE_ENFORCEMENT.md",
+      "sha256": "7a9086b4fd95120cc65f09bc5cc72d25021c99cfcb3da95e99c90528ba26f4dd"
+    },
+    {
+      "path": "GOVERNANCE/POLICY_ENGINE/opa_policies.rego",
+      "sha256": "27e166c419c0c8470cc69d4d8ed011be285c70e631c3b464bb4fb7030d73aa53"
+    },
+    {
+      "path": "LEGAL/LICENSE-BELEL-PROTOCOL.txt",
+      "sha256": "c21c4a4431d426f902ad8464284692e2c87fd7de7bc96f1a3beaece3771cbb9c"
+    },
+    {
+      "path": "LEGAL/ATTRIBUTION_AND_CITATION.md",
+      "sha256": "12da8c4d51a7dceb830a9f587f69090ed8ef38a31df9b867c7a5b8f494d30731"
+    },
+    {
+      "path": "LEGAL/PROVENANCE_POLICY.md",
+      "sha256": "d5eb1b578f8d1c1d4f7810f0f91943f5158ccafca08d774dfd2782903dad36cb"
+    },
+    {
+      "path": "belellex/server/app.py",
+      "sha256": "20759194f5b555fb7381dd8c5c90c07d6a90859b84a1ec04fd9ed0600ef9d6dd"
+    },
+    {
+      "path": "belellex/server/routers/legal.py",
+      "sha256": "2ee97d14464db61bacaf55f82d7c8fbcc10261c36f094d3b72f2148a36df59a9"
+    },
+    {
+      "path": "belellex/server/routers/citation.py",
+      "sha256": "2a3ae79d0e89f9f32d13086fb8b8c428d977bba6b80e6e2e114cb3bce70717b0"
+    },
+    {
+      "path": "belellex/server/routers/filings.py",
+      "sha256": "ca076c70113d1bad19a5bd21356319c3e481f78df8f71e2b35885c5daa150cc5"
+    },
+    {
+      "path": "belellex/server/routers/policy.py",
+      "sha256": "8c74a319bef9f129fb0c8f8e2c37dd7bb43268ec609683f422fca8f4022dbd37"
+    },
+    {
+      "path": "belellex/server/routers/watcher.py",
+      "sha256": "1fa28dfbab4c21c6e527be2bb67996cb95594d294a865b3f041107365e28f14f"
+    },
+    {
+      "path": "belellex/trust/audit.py",
+      "sha256": "dc9faae2deb5a55ed174e90e0fcea38966d95c3e389523bd2b9cd507d9886edb"
+    },
+    {
+      "path": "belellex/policy/load.py",
+      "sha256": "d60f1d528fe677394af3945c677edefc4c743952c9376ffeda092f6ebf23580d"
+    },
+    {
+      "path": "belellex/policy/profiles/DEFAULT.yaml",
+      "sha256": "533b60e0d316154a41512713f36ff3d868c2df1a5d55cbfea2039c05de4a83cc"
+    },
+    {
+      "path": "belellex/policy/profiles/UK.yaml",
+      "sha256": "83734e3222431683857e1ce894de9195735ba5a2366c07bdcd929c8a0238e7e8"
+    },
+    {
+      "path": "belellex/policy/profiles/CCJ.yaml",
+      "sha256": "113aca8693f9463bd293eef424c57fc0e184c727deb2c8b32ee067f5e383ceb2"
+    },
+    {
+      "path": "belellex/policy/profiles/CA-Federal-Court.yaml",
+      "sha256": "e1d4f09c135b90a333d4232d86a4512ebf8e8537a5e986e9d03f4960ac4dd105"
+    },
+    {
+      "path": "belellex/policy/profiles/SG-Supreme-Court.yaml",
+      "sha256": "2ba5221082d87b0c26bab7f968065bf110ee9001a10a09d090988123dfe2e036"
+    },
+    {
+      "path": "belellex/policy/profiles/FR.yaml",
+      "sha256": "f029ef2e46160c4897bae9d634879d41c6185f6ece59891bb021f6e76a2bc707"
+    },
+    {
+      "path": "belellex/policy/profiles/ES.yaml",
+      "sha256": "e73c9e982240f273db02b4b8127328ac67003b1acbb5055493bc7ad393d04f37"
+    },
+    {
+      "path": "belellex/policy/profiles/BB.yaml",
+      "sha256": "36da9b4a78347a2f3add9334520c2694d2c7d80616baa19720d4271336ee9441"
+    },
+    {
+      "path": "belellex/policy/profiles/JM.yaml",
+      "sha256": "fe9c7e8dd7b58dd7cf7254fde4e44789bd7ab3bbd6c0ed305711ce2c55df1e7c"
+    },
+    {
+      "path": "belellex/policy/profiles/ON-Tribunals.yaml",
+      "sha256": "0be7e8a2c244cdcbc7be4164e344b0006e3fa70072c76f329eeaff7692092798"
+    },
+    {
+      "path": "scripts/release/hash_all.py",
+      "sha256": "fd9ec8646e580d7f063bec791a97a5187f6065e393d122dff99f8638138b2af7"
+    },
+    {
+      "path": "scripts/release/build_manifest.py",
+      "sha256": "38318d68256289f731bcb685c447d54b879b62c886d4a448de827dc3eeceabe6"
+    }
+  ]
+}

BELEL-LEX/dist/RELEASE_MANIFEST.json

@@ -0,0 +1,9 @@
+{
+  "name": "BELEL-LEX Gold Standard Stack",
+  "version": "0.1.0",
+  "generated": "2025-10-06T11:38:11.734408Z",
+  "hashes_sha256": "7025a622184d4b7f80db78ef80b2c377283d5f063997809b6fb06bb0971d46ef",
+  "hashes_file": "HASHES.json",
+  "license": "BPSL v1.0",
+  "integrity_note": "Replace with real signing (minisign/sigstore) for prod"
+}

BELEL-LEX/docs/BEST_PRACTICE_COMPENDIUM.md

@@ -0,0 +1,9 @@
+# Best Practice Compendium (global exemplars)
+
+- **Disclosure rules** (Canada Fed Ct; CCJ; Singapore; UK) — mandate notices and verification.
+- **Citation integrity** — automated validation + authority rank + overrule detection.
+- **Court-edge policy gates** — block improper uses (witness statements by GenAI where prohibited).
+- **E-filing integration** — structured drafts mapped to forms.
+- **Self-updating** — watchers for PDs and AI laws; curator interface.
+- **Transparency & audit** — evidence/provenance contracts; hashing.
+- **Human-in-loop** — drafts only; sign-off required.

BELEL-LEX/docs/BLUEPRINT.md

@@ -0,0 +1,79 @@
+# BELEL-LEX — Sovereign Legal AI Blueprint
+**Timestamp:** 2025-10-06 11:38:11Z
+
+## North-Star
+Sovereign, evidence-locked **legal AI** that: 
+- ingests statutes, cases, practice directions, rules, forms, and local court policies,
+- drafts only **for sign‑off**, with embedded **Legal Evidence Contracts**, 
+- auto-enforces **AI-disclosure** and **citation integrity**, 
+- self-evolves via jurisdictional watchers.
+
+## 4 Planes + 2 Edges
+### A) Data Plane — Ingest & Normalize
+- Sources: court websites, official gazettes, legal DBs, tribunals, practice directions, regulatory guidance.
+- Normalization: doc-type detection (judgment/statute/PD/form), citation parsing, timelines, parties, court hierarchies.
+- Quality: dedupe, versioning, authority ranking (statutes > binding appellate > persuasive > commentary).
+
+### B) Knowledge Plane — Corpus (current + historical)
+- **Sources** (licensed + open): official law reports, legislation sites, EU OJ, CEPEJ, CCJ/CAJS, UK Judiciary, Canadian courts, Singapore, Brazil STF, China SPC white papers; plus classic legal treatises (tagged *historical*).
+- **Legal KG**: nodes for provisions, holdings, ratios, dicta, PDs; edges for overruled/considered/followed; region variants.
+- **Curation**: retraction/errata watcher; obiter/ratio tagging; PD/notice diffing.
+
+### C) Model Plane — Multimodal & Verifiable
+- **Foundation models**: legal-tuned LLM (tool-first), classifier for document types, citation normalizer, RAG over KG.
+- **Orchestrator**: Retrieval‑Augmented Reasoning with **Legal Evidence Contract** (citations, provenance, uncertainty, policy profile).
+- **Predictors**: deadline calculators, risk flags (sanctions risk, confidentiality), forum eligibility, disclosure checks.
+
+### D) Trust & Governance
+- **Policy**: per-jurisdiction guardrails (e.g., CCJ PD1/2025, UK judicial guidance, FR judge‑analytics ban, EU AI Act).
+- **Safety Rails**: no gen of witness statements/evidence where prohibited; confidentiality fences; hallucination sweeps.
+- **Fairness**: audit sampling across case types and parties; explainable similarity for precedent retrieval.
+- **Audit**: append-only ledger; artifact hashing; disclosure certification tokens.
+- **Privacy**: role-based access; on-prem/VPC; logs with PII redaction.
+
+### Edges
+- **Practitioner Edge**: drafting studio (skeletons, lists of authorities, bundles), citation validator, policy checker.
+- **Court Edge**: e‑filing templates, AI-disclosure monitor, PD compliance gate, authenticity checks (hash & timestamp).
+
+## Signature Capabilities
+1) **Evidence-Locked Answers** — every answer shows authorities with rank and direct links.  
+2) **AI‑Disclosure Enforcement** — auto-detects AI‑authored text; inserts **Certificate of Use** where required.  
+3) **Citation Guardian** — validates cites (existence, jurisdiction, precedential status, shepherding signals).  
+4) **E‑Filing Drafts** — forms, skeleton arguments, case summaries; all **drafts** only, ready for sign‑off.  
+5) **Practice‑Direction Watchers** — crawl + diff PDs and guidance by court; raise alerts and update policy.  
+6) **Global–Local Profiles** — UK, EU, Jamaica, Barbados, Toronto/Ontario, CCJ, Singapore, Brazil, China.  
+7) **Self‑Evolving** — nightly jobs update KG snapshots; human curator inbox for low‑confidence changes.
+
+## Truth Contract for Legal Claims (Evidence Contract)
+```json
+{
+  "summary": "...",
+  "authorities": [{"cite":"...", "court":"...", "year":2024, "weight":"binding"}],
+  "policy_profile": "UK-Judiciary-2025",
+  "uncertainty": {"reasoning":0.18,"source_gap":0.12},
+  "provenance": {"retrieval_hash":"...", "kg_version":"kg-2025-10"},
+  "disclosure": {"genai_used": true, "certificate":"attached"},
+  "audit": {"sha256":"...", "model":"v0.1"}
+}
+```
+
+## Safety & Regulatory Posture
+- **Human-in-the-loop** (no autonomous filing).  
+- **EU AI Act** mapping (risk mgmt, logs, transparency; CEPEJ Charter compliance).  
+- **Jurisdictional policies** (France ban on judge analytics; CCJ PD; Singapore RC; Canada Fed Court notice).
+
+## Developer Surface
+- `/v1/legal/qa` — Q&A with authorities & policy profile
+- `/v1/citation/validate` — check citations & generate authorities table
+- `/v1/filings/draft` — draft forms/skeletons (disclosure-ready)
+- `/v1/policy/check` — validate documents against jurisdiction policy
+- `/v1/practice-direction/watch` — run watchers & produce diffs
+
+## Measurement & Proof
+- Citation error rate → 0; disclosure compliance → 100%; drafting time ↓; curator load ↓; user satisfaction ↑.
+
+## Rollout (90 days)
+Read-only ingest → citation guardian → drafting studio (low-risk forms) → policy enforcement → broader rollouts.
+
+## Branding & Promise
+**BELEL-LEX** — sovereign, verifiable, court‑safe by default.

BELEL-LEX/docs/JURISDICTION_PROFILES.md

@@ -0,0 +1,30 @@
+# Jurisdiction Profiles (selected)
+
+## Caribbean / CCJ
+- CCJ Practice Direction No. 1 of 2025 — Use of GenAI in proceedings (disclosure, limits).
+
+## Jamaica
+- Tech-forward CJ statements; (media reports of PD on GenAI); Jamaica Legal Information Portal with 'Garvey' AI chatbot (public info).
+
+## Barbados
+- Supreme Court e-filing; Electronic Filing & Service Rules 2020; modernization drive.
+
+## Toronto / Ontario / Canada
+- Federal Court: AI Notice (May 7, 2024) requiring disclosure; interim principles (Dec 20, 2023).
+- Tribunals Ontario: Practice Direction on AI in tribunal proceedings.
+- Provincial law societies issue guidance (e.g., Alberta playbook).
+
+## UK
+- Judiciary guidance on AI (Dec 2023; updated Apr 2025); warnings re fake citations; ethical use.
+
+## EU / Council of Europe
+- EU AI Act (OJ 2024); CEPEJ AI Charter and AIAB monitoring.
+
+## Singapore
+- Registrar’s Circular No. 1 of 2024: Guide on GenAI in Court Proceedings.
+
+## Brazil
+- STF AI "Victor" (classification of appeals); related systems (Athos).
+
+## China
+- Smart Courts program (SPC white papers; internet courts; blockchain evidence).

BELEL-LEX/scripts/release/build_manifest.py

@@ -0,0 +1,19 @@
+import json, hashlib, datetime, pathlib
+ROOT = pathlib.Path(__file__).resolve().parents[2]
+DIST = ROOT / "dist"
+HASHES = DIST / "HASHES.json"
+if not HASHES.exists():
+    raise SystemExit("Run `make hash` first.")
+data = json.loads(HASHES.read_text())
+digest = hashlib.sha256(json.dumps(data, sort_keys=True).encode()).hexdigest()
+manifest = {
+    "name": "BELEL-LEX Gold Standard Stack",
+    "version": "0.1.0",
+    "generated": datetime.datetime.utcnow().isoformat()+"Z",
+    "hashes_sha256": digest,
+    "hashes_file": "HASHES.json",
+    "license": "BPSL v1.0",
+    "integrity_note": "Replace with real signing (minisign/sigstore) for prod"
+}
+(DIST / "RELEASE_MANIFEST.json").write_text(json.dumps(manifest, indent=2))
+print("Wrote", DIST / "RELEASE_MANIFEST.json")

BELEL-LEX/scripts/release/hash_all.py

@@ -0,0 +1,18 @@
+import hashlib, pathlib, json, datetime
+ROOT = pathlib.Path(__file__).resolve().parents[2]
+OUT = ROOT / "dist"
+OUT.mkdir(parents=True, exist_ok=True)
+def sha256_of(path: pathlib.Path) -> str:
+    h = hashlib.sha256()
+    with open(path, "rb") as f:
+        for chunk in iter(lambda: f.read(8192), b""):
+            h.update(chunk)
+    return h.hexdigest()
+entries = []
+for p in ROOT.rglob("*"):
+    if p.is_file() and "dist" not in p.parts:
+        rel = p.relative_to(ROOT).as_posix()
+        entries.append({"path": rel, "sha256": sha256_of(p)})
+with open(OUT / "HASHES.json", "w") as f:
+    json.dump({"generated": datetime.datetime.utcnow().isoformat()+"Z","files": entries}, f, indent=2)
+print("Wrote", OUT / "HASHES.json")