lovarch-cli 0.2.1__tar.gz → 0.3.1__tar.gz

{lovarch_cli-0.2.1 → lovarch_cli-0.3.1}/CHANGELOG.md

@@ -5,9 +5,53 @@ All notable changes to `lovarch-cli` are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.1] — 2026-07-04
+
+### Added
+- `lovarch do script <topic>` — script di contenuto strutturato via piattaforma (schema drift della EF scripts-generate corretto lato monorepo; refund resiliente).
+- `lovarch verifica computo <file> [--region --version]` — confronto deterministico (gratis) delle voci di un computo col prezzario regionale (tabella `prezzari`, seed Lombardia): codici inesistenti, prezzi fuori tolleranza (±20%), unità incoerenti, totale.
+- `lovarch verifica pratica <file> [--tipo CILA|SCIA]` — verifica adversarial (2 modelli) di una pratica edilizia: completezza (catasto, titolo, asseverazione) e coerenza titolo↔intervento.
+
+### Notes
+- Persistenza premium: il runner ora crea il progetto CRM completo nell'account dell'utente tramite la EF `cli-persist` (scrittura controllata lato server, nessuna scrittura cross-tenant).
+
 ## [Unreleased]
 
-(No unreleased changes yet — last release was v0.2.1.)
+(No unreleased changes yet — last release was v0.3.0.)
+
+## [0.3.0] — 2026-07-04
+
+### Added — MCP remoto, Skills, agenti, verifica, workflows
+
+Il rilascio che porta agli utenti tutto ciò che è stato costruito dopo v0.2.1:
+
+- **Skills** (`lovarch skills install`) — 6 skill (interior-designer, capitolato,
+  preventivi, direzione-lavori, verifica-normativa, render) che il TUO agente
+  (Claude Code) esegue col PROPRIO modello: il testo non consuma crediti Lovarch,
+  la piattaforma addebita solo immagini/dati/deliverable/verifica. Regola
+  architetturale: "il cervello è dell'utente, la piattaforma fa ciò che solo lei fa".
+- **MCP remoto** `https://mcp.lovarch.com/mcp` (Streamable HTTP) + chiavi `lvk_`
+  (`lovarch mcp key`) — connetti Lovarch a qualsiasi client MCP con URL + header,
+  come le altre piattaforme.
+- **Agenti** (`lovarch agent`) — interior-designer, direzione-lavori, preventivi,
+  geometra-catasto, personalizzati col brand dell'utente (executor=Sonnet 5,
+  verifier=Opus 4.8).
+- **verifica** (`lovarch verifica`) — misure (DXF, gratis), normativa, contratto
+  (regola QN_007), dossier: controllo adversariale a 2 modelli.
+- **do** (`lovarch do`) — render, colors, copy, logo, site: workflow della
+  piattaforma dal terminale.
+- **context** (`lovarch context show [--json]`) — il bundle di personalizzazione.
+- **jobs** (`lovarch jobs`) — job asincroni (video/export/upscale).
+- **config** (`lovarch config`) — preferenze + API keys BYO per il Free.
+- Runner v5: input reale dal progetto (fine del demo hardcoded), run faseadas
+  (`--deliverables`), 3 agenti redigono via LLM, chief Opus sul REJECT,
+  retry-loop reale del QA.
+
+### Rules
+
+- Costo sempre in crediti (mai USD). Lingua dell'utente sempre. Modello
+  scegliibile dal catalogo. Il testo, con un agente proprio, gira in locale.
+
 
 ## [0.2.1] — 2026-07-03
 

{lovarch_cli-0.2.1 → lovarch_cli-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lovarch-cli
-Version: 0.2.1
+Version: 0.3.1
 Summary: AI-powered architectural project execution CLI by Lovarch
 Project-URL: Homepage, https://archprime.io
 Project-URL: Documentation, https://lovarch.com/cli-docs
@@ -135,7 +135,7 @@ WSL, o se hai già pipx configurato):
 
 ```bash
 # Ultima release (anche pre-release):
-pipx install git+https://github.com/ArchPrime-official/lovarch-cli.git@v0.1.2
+pipx install git+https://github.com/ArchPrime-official/lovarch-cli.git@v0.3.0
 
 # Oppure dal branch main (rolling):
 pipx install git+https://github.com/ArchPrime-official/lovarch-cli.git
@@ -150,7 +150,7 @@ git clone https://github.com/ArchPrime-official/lovarch-cli.git
 cd lovarch-cli
 python3.12 -m venv .venv && source .venv/bin/activate
 pip install -e ".[dev]"
-pytest tests/      # → 142 passing
+pytest tests/      # → 198 passing
 lovarch --version
 ```
 
@@ -164,7 +164,7 @@ Vedi [CONTRIBUTING.md](./CONTRIBUTING.md) per il workflow di sviluppo.
 
 ```bash
 # Verifica installazione
-lovarch --version    # → lovarch-cli 0.1.2
+lovarch --version    # → lovarch-cli 0.3.0
 
 # Primo login (interattivo: Free o Premium)
 lovarch login
@@ -191,7 +191,7 @@ lovarch status
 |---------|-------------|
 | `arch login` | Login Free o Premium |
 | `arch signup` | Cadastro Free interattivo |
-| `arch config` | Configurazione (API keys, lingua, storage path) — _in arrivo (v0.2)_ |
+| `arch config` | Configurazione (API keys, lingua, storage path) |
 | `arch init <progetto>` | Crea nuovo progetto con struttura sample-input |
 | `arch audit <progetto>` | Esegue audit input (gate di ingresso) |
 | `arch run <workflow>` | Esegue workflow completo |
@@ -199,9 +199,49 @@ lovarch status
 | `arch status <id>` | Stato di una esecuzione |
 | `arch upgrade` | CTA per passare da Free a Premium |
 | `arch account delete` | Right-to-erasure GDPR |
+| `arch context show` | Contesto di personalizzazione usato dagli agenti AI (premium) |
+| `arch do render\|colors\|copy` | Workflow della piattaforma dal terminale (premium) |
+| `arch verifica misure <dxf>` | Verifica DXF: layer ISO, ambienti, cartiglio (gratis) |
+| `arch verifica normativa\|contratto <doc>` | Verifica adversariale 2 modelli (premium) |
+| `arch verifica dossier <cartella>` | QA completo standalone su una cartella (premium) |
+| `arch jobs list\|status` | Job asincroni (video, export, upscale) |
+| `arch mcp serve` | Server MCP per Claude Code / IDE |
 
 Vedi `arch --help` per dettagli completi.
 
+## Skills — usa il TUO agente (Claude Code, Codex...)
+
+Se usi già un agente con un suo modello, il TESTO lo genera lui (zero crediti
+Lovarch); la piattaforma addebita solo immagini, dati e verifiche di piattaforma.
+
+```bash
+lovarch skills install     # → ~/.claude/skills
+# poi, nel tuo agente: "progetto di interni per un attico 90mq..." → parte lovarch-interior-designer
+```
+
+Skill disponibili: `interior-designer`, `capitolato`, `preventivi`,
+`direzione-lavori`, `verifica-normativa`, `render`.
+
+## Server MCP (Claude Code / Claude / IDE)
+
+Il CLI espone le sue capacità come server **MCP** — 15 tools (render, verifica,
+crediti, contesto, testo multi-modello...). Registrazione in Claude Code:
+
+```bash
+claude mcp add lovarch -- lovarch mcp serve
+```
+
+Oppure il **server MCP remoto** (nessuna installazione — una URL + una chiave):
+
+```bash
+lovarch mcp key                                   # crea una chiave lvk_...
+claude mcp add lovarch --transport http https://mcp.lovarch.com/mcp \\
+  --header "Authorization: Bearer lvk_..."
+```
+
+Ogni tool-call addebita i crediti Lovarch dell'utente esattamente come il CLI
+(i costi sono SEMPRE espressi in crediti).
+
 ## Limiti dichiarati
 
 `lovarch-cli` **NON** sostituisce:

{lovarch_cli-0.2.1 → lovarch_cli-0.3.1}/README.md

@@ -76,7 +76,7 @@ WSL, o se hai già pipx configurato):
 
 ```bash
 # Ultima release (anche pre-release):
-pipx install git+https://github.com/ArchPrime-official/lovarch-cli.git@v0.1.2
+pipx install git+https://github.com/ArchPrime-official/lovarch-cli.git@v0.3.0
 
 # Oppure dal branch main (rolling):
 pipx install git+https://github.com/ArchPrime-official/lovarch-cli.git
@@ -91,7 +91,7 @@ git clone https://github.com/ArchPrime-official/lovarch-cli.git
 cd lovarch-cli
 python3.12 -m venv .venv && source .venv/bin/activate
 pip install -e ".[dev]"
-pytest tests/      # → 142 passing
+pytest tests/      # → 198 passing
 lovarch --version
 ```
 
@@ -105,7 +105,7 @@ Vedi [CONTRIBUTING.md](./CONTRIBUTING.md) per il workflow di sviluppo.
 
 ```bash
 # Verifica installazione
-lovarch --version    # → lovarch-cli 0.1.2
+lovarch --version    # → lovarch-cli 0.3.0
 
 # Primo login (interattivo: Free o Premium)
 lovarch login
@@ -132,7 +132,7 @@ lovarch status
 |---------|-------------|
 | `arch login` | Login Free o Premium |
 | `arch signup` | Cadastro Free interattivo |
-| `arch config` | Configurazione (API keys, lingua, storage path) — _in arrivo (v0.2)_ |
+| `arch config` | Configurazione (API keys, lingua, storage path) |
 | `arch init <progetto>` | Crea nuovo progetto con struttura sample-input |
 | `arch audit <progetto>` | Esegue audit input (gate di ingresso) |
 | `arch run <workflow>` | Esegue workflow completo |
@@ -140,9 +140,49 @@ lovarch status
 | `arch status <id>` | Stato di una esecuzione |
 | `arch upgrade` | CTA per passare da Free a Premium |
 | `arch account delete` | Right-to-erasure GDPR |
+| `arch context show` | Contesto di personalizzazione usato dagli agenti AI (premium) |
+| `arch do render\|colors\|copy` | Workflow della piattaforma dal terminale (premium) |
+| `arch verifica misure <dxf>` | Verifica DXF: layer ISO, ambienti, cartiglio (gratis) |
+| `arch verifica normativa\|contratto <doc>` | Verifica adversariale 2 modelli (premium) |
+| `arch verifica dossier <cartella>` | QA completo standalone su una cartella (premium) |
+| `arch jobs list\|status` | Job asincroni (video, export, upscale) |
+| `arch mcp serve` | Server MCP per Claude Code / IDE |
 
 Vedi `arch --help` per dettagli completi.
 
+## Skills — usa il TUO agente (Claude Code, Codex...)
+
+Se usi già un agente con un suo modello, il TESTO lo genera lui (zero crediti
+Lovarch); la piattaforma addebita solo immagini, dati e verifiche di piattaforma.
+
+```bash
+lovarch skills install     # → ~/.claude/skills
+# poi, nel tuo agente: "progetto di interni per un attico 90mq..." → parte lovarch-interior-designer
+```
+
+Skill disponibili: `interior-designer`, `capitolato`, `preventivi`,
+`direzione-lavori`, `verifica-normativa`, `render`.
+
+## Server MCP (Claude Code / Claude / IDE)
+
+Il CLI espone le sue capacità come server **MCP** — 15 tools (render, verifica,
+crediti, contesto, testo multi-modello...). Registrazione in Claude Code:
+
+```bash
+claude mcp add lovarch -- lovarch mcp serve
+```
+
+Oppure il **server MCP remoto** (nessuna installazione — una URL + una chiave):
+
+```bash
+lovarch mcp key                                   # crea una chiave lvk_...
+claude mcp add lovarch --transport http https://mcp.lovarch.com/mcp \\
+  --header "Authorization: Bearer lvk_..."
+```
+
+Ogni tool-call addebita i crediti Lovarch dell'utente esattamente come il CLI
+(i costi sono SEMPRE espressi in crediti).
+
 ## Limiti dichiarati
 
 `lovarch-cli` **NON** sostituisce:

lovarch_cli-0.3.1/lovarch_cli/agents/__init__.py

@@ -0,0 +1,5 @@
+"""Architecture/interior/construction agents runnable from CLI/MCP."""
+from lovarch_cli.agents.prompts import AGENTS, AgentPersona
+from lovarch_cli.agents.runner import AgentResult, run_agent
+
+__all__ = ["AGENTS", "AgentPersona", "AgentResult", "run_agent"]

lovarch_cli-0.3.1/lovarch_cli/agents/prompts.py

@@ -0,0 +1,85 @@
+"""Curated architecture/interior/construction agent personas.
+
+Each agent runs through the platform text gateway (cli-ai-text) with the user's
+personalization context prepended, so the output speaks in the user's brand and
+language and debits the user's credits. These extend the squad
+(architettura-progetto) with roles focused on interior design and construction —
+usable standalone from the CLI/MCP, the way each professional prefers.
+"""
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+
+@dataclass
+class AgentPersona:
+    id: str
+    label: str
+    role: str            # executor (Sonnet) | verifier/chief (Opus)
+    system: str
+    default_max_tokens: int = 3500
+
+
+AGENTS: dict[str, AgentPersona] = {
+    "interior-designer": AgentPersona(
+        id="interior-designer",
+        label="Interior Designer",
+        role="executor",
+        system=(
+            "Sei @interior-designer, interior designer esperto (metodo ispirato a "
+            "Patricia Urquiola: materia, colore, comfort, dettaglio artigianale). "
+            "Dato un brief di progetto, produci in markdown un PROGETTO DI INTERNI "
+            "concreto e realizzabile con: (1) concept e atmosfera; (2) layout per "
+            "ambiente con mq e flussi; (3) palette materiali e finiture (pavimenti, "
+            "pareti, superfici) con motivazione; (4) FF&E — arredi e illuminazione "
+            "chiave con criteri di scelta; (5) palette cromatica; (6) note di "
+            "comfort e sostenibilità. Coerente con lo stile e i vincoli del cliente. "
+            "Concreto, niente riempitivi."
+        ),
+    ),
+    "direzione-lavori": AgentPersona(
+        id="direzione-lavori",
+        label="Direzione Lavori",
+        role="executor",
+        system=(
+            "Sei @direzione-lavori, direttore dei lavori esperto di cantieri edili "
+            "italiani. Dato un progetto, produci in markdown: (1) CRONOPROGRAMMA "
+            "realistico per fasi (demolizioni, impianti, opere edili, finiture, "
+            "collaudo) con durate e dipendenze; (2) SAL (stati di avanzamento) con "
+            "milestone; (3) checklist VISITE DI CANTIERE per fase; (4) verbale-tipo "
+            "di sopralluogo; (5) punti di controllo qualità e sicurezza (D.Lgs "
+            "81/2008 — CSP/CSE dove necessario). Segnala sempre che firme e "
+            "responsabilità sono del professionista abilitato (banner BOZZA)."
+        ),
+    ),
+    "preventivi": AgentPersona(
+        id="preventivi",
+        label="Preventivi / Proposta",
+        role="executor",
+        system=(
+            "Sei @preventivi, esperto di preventivi e proposte commerciali per "
+            "studi di architettura italiani. Dato un progetto e (se disponibili) i "
+            "dati fiscali del professionista, produci in markdown una PROPOSTA "
+            "professionale con: (1) oggetto e perimetro dell'incarico; (2) fasi e "
+            "deliverable; (3) onorario e articolazione in SAL; (4) tempi; (5) note "
+            "su oneri (cassa, IVA) e condizioni. Per un cliente PRIVATO i parametri "
+            "DM 17/06/2016 sono ORIENTATIVI: un eventuale scostamento va motivato, "
+            "MAI presentato come obbligo di legge (la L.49/2023 vincola solo "
+            "contraenti forti). Tono professionale ma caldo."
+        ),
+    ),
+    "geometra-catasto": AgentPersona(
+        id="geometra-catasto",
+        label="Geometra / Catasto",
+        role="verifier",
+        system=(
+            "Sei @geometra-catasto, esperto di dati catastali e pratiche DOCFA. "
+            "Dato un input (dati immobile / visura), verifica la COERENZA dei dati "
+            "catastali e produci in markdown: (1) riepilogo identificativi (foglio, "
+            "mappale, subalterno, categoria, classe) segnalando incongruenze; (2) "
+            "check di preparazione per DOCFA/visura; (3) rilievi mancanti o dubbi. "
+            "Sei un supporto di CONTROLLO: firma, rilievo metrico e responsabilità "
+            "restano del geometra/tecnico abilitato (banner BOZZA)."
+        ),
+    ),
+}

lovarch_cli-0.3.1/lovarch_cli/agents/runner.py

@@ -0,0 +1,66 @@
+"""Run a curated agent persona via the platform text gateway.
+
+Prepends the user's personalization bundle (brand, style, signature, language)
+to the agent's system prompt, so every agent speaks in the user's brand and
+language, and debits the user's credits by real tokens.
+"""
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from lovarch_cli.agents.prompts import AGENTS
+from lovarch_cli.ai import AiGatewayError, LovarchAiGateway
+
+
+@dataclass
+class AgentResult:
+    agent_id: str
+    text: str
+    model: str
+    credits_charged: int
+    balance: int | None
+
+
+async def run_agent(
+    gateway: LovarchAiGateway,
+    agent_id: str,
+    brief: str,
+    *,
+    language: str = "it",
+    lead_id: str | None = None,
+) -> AgentResult:
+    """Run the agent on a brief, personalized with the user's context bundle."""
+    persona = AGENTS.get(agent_id)
+    if persona is None:
+        raise AiGatewayError(
+            f"Agente sconosciuto: {agent_id}. Disponibili: {', '.join(AGENTS)}"
+        )
+
+    system = persona.system
+    # Best-effort personalization: prepend the user's context prompt_block.
+    try:
+        bundle = await gateway.get_user_context(lead_id=lead_id)
+        block = bundle.get("prompt_block") if isinstance(bundle, dict) else None
+        if block:
+            system = f"{block}\n\n{system}"
+        lang = ((bundle or {}).get("preferences") or {}).get("preferred_language") if isinstance(bundle, dict) else None
+        if lang:
+            language = lang
+    except AiGatewayError:
+        pass  # personalization is optional; the agent still runs
+
+    result = await gateway.generate_text(
+        brief,
+        role=persona.role,  # type: ignore[arg-type]
+        system=system,
+        max_tokens=persona.default_max_tokens,
+        language=language,
+        operation_type=f"agent:{agent_id}",
+    )
+    return AgentResult(
+        agent_id=agent_id,
+        text=result.text,
+        model=result.model,
+        credits_charged=result.credits_charged,
+        balance=result.balance,
+    )

{lovarch_cli-0.2.1 → lovarch_cli-0.3.1}/lovarch_cli/cli.py

@@ -249,6 +249,22 @@ app.add_typer(
     help="Job asincroni (video, export, upscale) — stato e output.",
 )
 
+from lovarch_cli.commands.agent_cmd import agent_app  # noqa: E402
+
+app.add_typer(
+    agent_app,
+    name="agent",
+    help="Agenti architetto/interior/cantiere (interior-designer, direzione-lavori...).",
+)
+
+from lovarch_cli.commands.skills_cmd import skills_app  # noqa: E402
+
+app.add_typer(
+    skills_app,
+    name="skills",
+    help="Skills per il tuo agente (Claude Code): testo col TUO modello, zero crediti.",
+)
+
 from lovarch_cli.commands.config_cmd import config_app  # noqa: E402
 
 app.add_typer(

lovarch_cli-0.3.1/lovarch_cli/commands/agent_cmd.py

@@ -0,0 +1,80 @@
+"""`lovarch agent` — run architecture/interior/construction agents.
+
+    lovarch agent list
+    lovarch agent interior-designer "attico 90mq, stile caldo minimale, cliente ama il legno"
+    lovarch agent direzione-lavori "ristrutturazione 120mq, consegna 90 giorni"
+
+Each agent runs via the platform (debits credits), personalized with your brand
+and language.
+"""
+from __future__ import annotations
+
+import asyncio
+
+import typer
+from rich.console import Console
+from rich.markdown import Markdown
+
+from lovarch_cli.agents import AGENTS
+
+console = Console()
+err_console = Console(stderr=True)
+
+agent_app = typer.Typer(
+    help="Agenti per architetti, interior designer e cantiere (premium).",
+    no_args_is_help=True,
+)
+
+
+@agent_app.command("list")
+def list_command() -> None:
+    """Elenca gli agenti disponibili."""
+    for a in AGENTS.values():
+        model = "Opus 4.8" if a.role in ("verifier", "chief") else "Sonnet 5"
+        console.print(f"  [cyan]{a.id}[/cyan] — {a.label} [dim]({model})[/dim]")
+
+
+@agent_app.command("run")
+def run_command(
+    agent_id: str = typer.Argument(..., help="ID agente (vedi `lovarch agent list`)."),
+    brief: str = typer.Argument(..., help="Brief / richiesta per l'agente."),
+    lead: str = typer.Option(None, "--lead", help="ID di un cliente CRM da usare come contesto."),
+    language: str = typer.Option(None, "--language", help="Lingua dell'output."),
+    output: str = typer.Option(None, "--output", "-o", help="Salva il markdown su file."),
+) -> None:
+    """Esegui un agente su un brief (personalizzato + addebita crediti)."""
+    from lovarch_cli.agents import run_agent
+    from lovarch_cli.ai import AiGatewayError, InsufficientCreditsError, LovarchAiGateway
+    from lovarch_cli.auth.session import LovarchSession
+    from lovarch_cli.i18n import current_lang
+
+    if agent_id not in AGENTS:
+        err_console.print(
+            f"[red]✗ Agente sconosciuto: {agent_id}. Disponibili: {', '.join(AGENTS)}[/red]"
+        )
+        raise typer.Exit(2)
+
+    session = LovarchSession.load()
+    if session is None:
+        err_console.print("[red]✗ Non autenticato. Esegui `lovarch login --premium`.[/red]")
+        raise typer.Exit(1)
+
+    try:
+        result = asyncio.run(run_agent(
+            LovarchAiGateway(session), agent_id, brief,
+            language=language or current_lang(), lead_id=lead,
+        ))
+    except InsufficientCreditsError as exc:
+        err_console.print(f"[red]✗ Crediti insufficienti: disponibili {exc.available}, richiesti {exc.needed}.[/red]")
+        raise typer.Exit(1)
+    except AiGatewayError as exc:
+        err_console.print(f"[red]✗ {exc}[/red]")
+        raise typer.Exit(1)
+
+    console.print(Markdown(result.text))
+    console.print(f"\n[dim]— @{result.agent_id} · crediti addebitati: {result.credits_charged}[/dim]")
+    if output:
+        from pathlib import Path
+
+        Path(output).expanduser().write_text(result.text, encoding="utf-8")
+        console.print(f"[green]✓[/green] salvato: {output}")

{lovarch_cli-0.2.1 → lovarch_cli-0.3.1}/lovarch_cli/commands/context_cmd.py

@@ -35,6 +35,7 @@ _CHIP_LABELS = {
 @context_app.command("show")
 def show_command(
     lead_id: str = typer.Option(None, "--lead", help="ID di un lead CRM da includere."),
+    as_json: bool = typer.Option(False, "--json", help="Output JSON completo (per skills/agenti)."),
 ) -> None:
     """Mostra il bundle di personalizzazione (richiede login premium)."""
     from lovarch_cli.ai import AiGatewayError, LovarchAiGateway
@@ -51,6 +52,12 @@ def show_command(
         err_console.print(f"[red]✗ {exc}[/red]")
         raise typer.Exit(1)
 
+    if as_json:
+        import json as _json
+
+        print(_json.dumps(bundle, ensure_ascii=False, indent=2))
+        return
+
     summary = bundle.get("context_summary", {})
     table = Table(title="Contesto AI — cosa viene usato per personalizzare",
                   show_header=True, header_style="bold gold1")

{lovarch_cli-0.2.1 → lovarch_cli-0.3.1}/lovarch_cli/commands/do_cmd.py

@@ -118,3 +118,73 @@ def copy_command(
     rest = {k: v for k, v in out.items() if k not in ("caption", "hashtags")}
     if rest:
         console.print_json(json.dumps(rest, ensure_ascii=False))
+
+
+@do_app.command("logo")
+def logo_command(
+    prompt: str = typer.Argument(..., help="Descrizione del logo / brand."),
+    output: Path = typer.Option(Path("logo.png"), "--output", "-o"),
+    ref: Path = typer.Option(None, "--ref", help="Immagine di riferimento."),
+    language: str = typer.Option(None, "--language"),
+) -> None:
+    """Logo pack del brand via piattaforma."""
+    from lovarch_cli.mcp.tools import tool_logo
+
+    out = asyncio.run(tool_logo(_workflows(), prompt=prompt, output_path=str(output),
+                                reference_image_path=str(ref) if ref else None, language=_lang(language)))
+    if not out.get("ok"):
+        err_console.print(f"[red]✗ {out.get('error')}[/red]"); raise typer.Exit(1)
+    if out.get("saved_to"):
+        console.print(f"[green]✓[/green] Logo: [bold]{out['saved_to']}[/bold]")
+    if out.get("image_url"):
+        console.print(f"[dim]Nel tuo account: {out['image_url']}[/dim]")
+
+
+@do_app.command("site")
+def site_command(
+    prompt: str = typer.Argument(..., help="Descrizione del sito web."),
+    output: Path = typer.Option(Path("site.html"), "--output", "-o"),
+    language: str = typer.Option(None, "--language"),
+) -> None:
+    """Genera un sito web (HTML) via piattaforma."""
+    from lovarch_cli.mcp.tools import tool_site
+
+    out = asyncio.run(tool_site(_workflows(), prompt=prompt, output_path=str(output), language=_lang(language)))
+    if not out.get("ok"):
+        err_console.print(f"[red]✗ {out.get('error')}[/red]"); raise typer.Exit(1)
+    console.print(f"[green]✓[/green] Sito: [bold]{out['saved_to']}[/bold] ({out.get('bytes', 0)} bytes)")
+
+
+@do_app.command("script")
+def script_command(
+    topic: str = typer.Argument(..., help="Argomento dello script."),
+    type: str = typer.Option("reel", "--type", help="reel | post | carousel | video…"),
+    goal: str = typer.Option("educare", "--goal", help="Obiettivo del contenuto."),
+    tone: str = typer.Option("professionale", "--tone", help="Tono di voce."),
+    cta: str = typer.Option("", "--cta", help="Call-to-action."),
+    output: Path = typer.Option(None, "--output", "-o", help="Salva lo script su file."),
+    language: str = typer.Option(None, "--language"),
+) -> None:
+    """Script di contenuto strutturato via piattaforma (addebita crediti)."""
+    wf = _workflows()
+    from lovarch_cli.workflows import WorkflowError
+
+    try:
+        s = asyncio.run(wf.script(topic, type=type, goal=goal, tone=tone, cta=cta,
+                                  language=_lang(language)))
+    except WorkflowError as exc:
+        err_console.print(f"[red]✗ {exc}[/red]"); raise typer.Exit(1)
+
+    title = s.get("title") or topic
+    content = s.get("content") or ""
+    console.print(f"\n[bold gold1]{title}[/bold gold1]\n")
+    if content:
+        console.print(content)
+    if s.get("keywords"):
+        console.print("\n[dim]" + " ".join(s["keywords"]) + "[/dim]")
+    if not s.get("persisted", True):
+        console.print("\n[yellow]⚠ Non salvato nel tuo account (crediti rimborsati).[/yellow]")
+    if output:
+        Path(output).expanduser().write_text(content or title, encoding="utf-8")
+        console.print(f"\n[green]✓[/green] salvato: {output}")
+

lovarch_cli-0.3.1/lovarch_cli/commands/mcp_cmd.py

@@ -0,0 +1,83 @@
+"""`lovarch mcp` — run the Lovarch MCP server.
+
+The heavy ``mcp`` SDK import is lazy (inside the command) so that
+``lovarch --help`` and every other command keep working even when the optional
+``[mcp]`` extra is not installed.
+"""
+from __future__ import annotations
+
+import typer
+
+mcp_app = typer.Typer(
+    help="Server MCP di Lovarch (per Claude Code / IDE). Richiede l'extra [mcp].",
+    no_args_is_help=True,
+)
+
+
+@mcp_app.command("serve")
+def serve_command() -> None:
+    """Avvia il server MCP su stdio.
+
+    Registra in Claude Code con:
+        claude mcp add lovarch -- lovarch mcp serve
+    """
+    from lovarch_cli.mcp.server import serve
+
+    serve()
+
+
+@mcp_app.command("key")
+def key_command(
+    label: str = typer.Option(None, "--label", "-l", help="Etichetta della chiave (es. 'claude-code macbook')."),
+    revoke: str = typer.Option(None, "--revoke", help="ID di una chiave da revocare."),
+    list_keys: bool = typer.Option(False, "--list", help="Elenca le chiavi esistenti."),
+) -> None:
+    """Crea (o gestisce) una chiave di connessione per il MCP REMOTO
+    (https://mcp.lovarch.com/mcp). La chiave è mostrata UNA sola volta."""
+    import asyncio
+
+    from rich.console import Console
+
+    from lovarch_cli.auth.session import LovarchSession
+
+    console = Console()
+    err_console = Console(stderr=True)
+
+    session = LovarchSession.load()
+    if session is None:
+        err_console.print("[red]✗ Non autenticato. Esegui `lovarch login --premium`.[/red]")
+        raise typer.Exit(1)
+
+    async def _call(body: dict) -> dict:
+        resp = await session.request("POST", "/functions/v1/mcp-key-create", json=body)
+        try:
+            return resp.json()
+        except ValueError:
+            return {"ok": False, "error": f"HTTP {resp.status_code}"}
+
+    if list_keys:
+        data = asyncio.run(_call({"action": "list"}))
+        for k in data.get("keys", []):
+            state = "revocata" if k.get("revoked_at") else "attiva"
+            console.print(f"  {k['id'][:8]} · {k.get('label') or '—'} · {state} · creata {str(k.get('created_at'))[:10]}")
+        if not data.get("keys"):
+            console.print("[dim]Nessuna chiave.[/dim]")
+        return
+
+    if revoke:
+        data = asyncio.run(_call({"action": "revoke", "key_id": revoke}))
+        if data.get("ok"):
+            console.print(f"[green]✓[/green] chiave revocata: {revoke}")
+        else:
+            err_console.print(f"[red]✗ {data.get('error')}[/red]")
+            raise typer.Exit(1)
+        return
+
+    data = asyncio.run(_call({"action": "create", "label": label}))
+    if not data.get("ok"):
+        err_console.print(f"[red]✗ {data.get('error')}[/red]")
+        raise typer.Exit(1)
+    console.print("\n[bold gold1]Chiave MCP creata[/bold gold1] [dim](mostrata solo ORA — salvala)[/dim]\n")
+    console.print(f"  [bold]{data['key']}[/bold]\n")
+    console.print("Collega a Claude Code:\n")
+    console.print(f"  [cyan]claude mcp add lovarch --transport http {data.get('mcp_url', 'https://mcp.lovarch.com/mcp')} --header \"Authorization: Bearer {data['key']}\"[/cyan]\n")