refactor: rename LegalIntern to LMAF (Legal Multi-Agent Framework) (#1)

Rename package from legal_intern to lmaf, class LegalIntern to LMAF,
update all UI strings, CLI entrypoint, and CI/CD references.

Co-authored-by: overthelex <mcvovkes@gmail.com>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

.github/workflows/deploy.yml

@@ -1,4 +1,4 @@
-name: Deploy LegalIntern
+name: Deploy LMAF
 
 on:
   push:
@@ -6,7 +6,7 @@ on:
   workflow_dispatch:
 
 concurrency:
-  group: deploy-legal-intern
+  group: deploy-lmaf
   cancel-in-progress: false
 
 jobs:
@@ -22,25 +22,25 @@ jobs:
         run: |
           ssh prod "cd ~/SecondLayer/deployment && \
             docker compose -f docker-compose.prod.yml --env-file .env.prod \
-            build --no-cache legal-intern-prod"
+            build --no-cache lmaf-prod"
 
       - name: Start container
         run: |
           ssh prod "cd ~/SecondLayer/deployment && \
             docker compose -f docker-compose.prod.yml --env-file .env.prod \
-            up -d legal-intern-prod"
+            up -d lmaf-prod"
 
       - name: Health check
         run: |
           for i in $(seq 1 45); do
-            if ssh prod "docker exec legal-intern-prod python -c \"import urllib.request; urllib.request.urlopen('http://localhost:7860/')\"" 2>/dev/null; then
+            if ssh prod "docker exec lmaf-prod python -c \"import urllib.request; urllib.request.urlopen('http://localhost:7860/')\"" 2>/dev/null; then
               echo "Container healthy after $((i*2))s"
               exit 0
             fi
             sleep 2
           done
           echo "Health check failed"
-          ssh prod "docker logs --tail 30 legal-intern-prod" || true
+          ssh prod "docker logs --tail 30 lmaf-prod" || true
           exit 1
 
   sync-hf:

README.md

@@ -1,5 +1,5 @@
 ---
-title: LegalIntern
+title: LMAF
 emoji: ⚖️
 colorFrom: blue
 colorTo: indigo
@@ -16,11 +16,11 @@ tags:
   - legal-consultation
 ---
 
-# LegalIntern
+# LMAF -- Legal Multi-Agent Framework
 
-A multi-agent scaffolding system for **complex legal consultations** over Ukrainian court decisions and legislation.
+A multi-agent framework for **complex legal consultations** over Ukrainian court decisions and legislation.
 
-Inspired by [PhysicsIntern](https://huggingface.co/spaces/huggingface/physics-intern)'s multi-agent research pipeline, adapted for the legal domain with access to 100M+ Ukrainian court decisions via [SecondLayer](https://legal.org.ua).
+Built for the legal domain with access to 100M+ Ukrainian court decisions via [SecondLayer](https://legal.org.ua).
 
 ## Architecture
 
@@ -103,10 +103,10 @@ export ANTHROPIC_API_KEY=sk-...
 export SECONDLAYER_API_KEY=...
 
 # Run a consultation
-legal-intern "Чи може продавець стягнути пеню за прострочення оплати товару?"
+lmaf "Чи може продавець стягнути пеню за прострочення оплати товару?"
 
 # Run from a problem file
-legal-intern problems/consumer_penalty.yaml
+lmaf problems/consumer_penalty.yaml
 ```
 
 ## Example Problems

app.py

@@ -1,4 +1,4 @@
-"""LegalIntern Gradio chat app.
+"""LMAF (Legal Multi-Agent Framework) Gradio chat app.
 
 Chat interface for multi-agent legal consultation pipeline.
 On prod (agents.legal.org.ua): runs the real pipeline with LLM + SecondLayer API.
@@ -35,11 +35,11 @@ def has_api_keys() -> bool:
 
 async def _run_pipeline(question: str):
     """Run the multi-agent pipeline and yield status updates."""
-    from legal_intern.core.config import Config
-    from legal_intern.engine import LegalIntern
+    from lmaf.core.config import Config
+    from lmaf.engine import LMAF
 
     config = Config.from_env()
-    intern = LegalIntern(question, config)
+    intern = LMAF(question, config)
 
     yield "Surveyor: аналізую правовий ландшафт..."
     result = await intern.surveyor.run(intern.state)
@@ -85,7 +85,7 @@ async def _run_pipeline(question: str):
                     await intern.planner.run(
                         intern.state, revision_critique=critique.details
                     )
-                    from legal_intern.state.research_state import CritiqueStatus
+                    from lmaf.state.research_state import CritiqueStatus
                     critique.status = CritiqueStatus.RESOLVED
 
             if "можна завершувати: True" in critic_result.summary:
@@ -164,7 +164,7 @@ def stream_chat(message: str, history: list[dict]):
 
 
 ARCHITECTURE_MD = """
-## Архітектура LegalIntern
+## Архітектура LMAF
 
 Дев'ять спеціалізованих LLM-агентів працюють у циклі. Кожен агент починає з чистого контексту.
 Весь стан зберігається у структурованому об'єкті `ConsultationState`.
@@ -237,9 +237,9 @@ DATASETS_MD = """
 
 
 def build_app() -> gr.Blocks:
-    with gr.Blocks(title="LegalIntern") as app:
+    with gr.Blocks(title="LMAF") as app:
         gr.Markdown(
-            "# LegalIntern\n"
+            "# LMAF -- Legal Multi-Agent Framework\n"
             "### Мульти-агентна система для складних правових консультацій\n\n"
             "Дев'ять спеціалізованих LLM-агентів аналізують правові питання, "
             "шукають судову практику у 100М+ рішень ЄДРСР та формують структуровану консультацію.\n\n"

pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-name = "legal-intern"
+name = "lmaf"
 version = "0.1.0"
 description = "Multi-agent scaffolding for complex legal consultations over Ukrainian court decisions"
 readme = "README.md"
@@ -35,7 +35,7 @@ all-providers = [
 ]
 
 [project.scripts]
-legal-intern = "legal_intern.main:cli"
+lmaf = "lmaf.main:cli"
 
 [build-system]
 requires = ["hatchling"]

src/legal_intern/__init__.py

@@ -1,3 +0,0 @@
-"""LegalIntern -- multi-agent scaffolding for complex legal consultations."""
-
-__version__ = "0.1.0"

src/lmaf/__init__.py

@@ -0,0 +1,3 @@
+"""LMAF -- Legal Multi-Agent Framework for complex legal consultations."""
+
+__version__ = "0.1.0"

src/{legal_intern → lmaf}/agents/base.py

@@ -28,7 +28,7 @@ class AgentResult:
 
 
 class BaseAgent(ABC):
-    """Base class for all LegalIntern agents."""
+    """Base class for all LMAF agents."""
 
     role: str = "base"
     description: str = ""

src/{legal_intern → lmaf}/core/config.py

@@ -1,4 +1,4 @@
-"""Configuration for the LegalIntern system."""
+"""Configuration for the LMAF system."""
 
 from __future__ import annotations
 

src/{legal_intern → lmaf}/engine.py

@@ -1,20 +1,4 @@
-"""LegalIntern main loop engine.
-
-Nine-agent pipeline for complex legal consultations:
-
-1. Surveyor   -- maps the legal landscape (runs once)
-2. Planner    -- produces/revises research strategy
-3. Orchestrator -- dispatches tasks to researcher or analyst
-4. Researcher -- finds case law, legislation, doctrine (via SecondLayer MCP)
-5. Analyst    -- computes deadlines, penalties, procedural checks
-6. Reviewer   -- adversarial verification of evidence (auto-triggered)
-7. Critic     -- periodic strategy audit (every N iterations)
-8. Adjudicator -- resolves inter-agent disagreements
-9. Formatter  -- produces final consultation document
-
-No agent carries conversation history. All state lives in ConsultationState.
-The workspace is git-versioned for full reproducibility.
-"""
+"""LMAF -- Legal Multi-Agent Framework main loop engine."""
 
 from __future__ import annotations
 
@@ -43,8 +27,8 @@ from .state.research_state import ConsultationState, CritiqueStatus
 console = Console()
 
 
-class LegalIntern:
-    """Main loop for the LegalIntern consultation system."""
+class LMAF:
+    """Main loop for the Legal Multi-Agent Framework."""
 
     def __init__(self, question: str, config: Config | None = None) -> None:
         self.config = config or Config.from_env()
@@ -70,7 +54,7 @@ class LegalIntern:
 
     async def run(self) -> str:
         """Execute the full consultation pipeline. Returns the final answer."""
-        console.print(Panel(f"[bold]LegalIntern[/bold]\n{self.state.client_question[:200]}"))
+        console.print(Panel(f"[bold]LMAF[/bold]\n{self.state.client_question[:200]}"))
 
         # Phase 1: Survey
         console.print("[dim]Phase 1: Surveyor[/dim]")

src/{legal_intern → lmaf}/main.py

@@ -1,4 +1,4 @@
-"""CLI entrypoint for LegalIntern."""
+"""CLI entrypoint for LMAF."""
 
 from __future__ import annotations
 
@@ -8,11 +8,11 @@ import sys
 from pathlib import Path
 
 from .core.config import Config
-from .engine import LegalIntern
+from .engine import LMAF
 
 
 def cli() -> None:
-    parser = argparse.ArgumentParser(description="LegalIntern -- multi-agent legal consultation")
+    parser = argparse.ArgumentParser(description="LMAF -- Legal Multi-Agent Framework")
     parser.add_argument("question", nargs="?", help="Legal question (or path to .yaml problem file)")
     parser.add_argument("--model", default=None, help="Override default LLM model")
     parser.add_argument("--max-iterations", type=int, default=None)
@@ -24,7 +24,6 @@ def cli() -> None:
         parser.print_help()
         sys.exit(1)
 
-    # Load config
     if args.config and args.config.exists():
         config = Config.from_yaml(args.config)
     else:
@@ -37,7 +36,6 @@ def cli() -> None:
     if args.workspace_dir:
         config.workspace_dir = args.workspace_dir
 
-    # Load question from file or use directly
     question = args.question
     if Path(question).exists():
         import yaml
@@ -45,8 +43,8 @@ def cli() -> None:
         data = yaml.safe_load(Path(question).read_text())
         question = data.get("question", data.get("problem", question))
 
-    intern = LegalIntern(question, config)
-    answer = asyncio.run(intern.run())
+    engine = LMAF(question, config)
+    answer = asyncio.run(engine.run())
 
     print("\n" + "=" * 60)
     print(answer)

src/{legal_intern → lmaf}/providers/__init__.py

@@ -1,4 +1,4 @@
-"""LLM provider abstraction layer -- AWS Bedrock only."""
+"""LMAF LLM provider -- AWS Bedrock only."""
 
 from __future__ import annotations