lovarch-cli 0.2.1__py3-none-any.whl

lovarch_cli/squad/workflows/dal-brief-al-cantiere.yaml

@@ -0,0 +1,218 @@
+name: dal-brief-al-cantiere
+version: 1.0.0
+description: >
+  Workflow principale del squad architettura-progetto.
+  Esegue progetto end-to-end: dal briefing del cliente al dossier consegnabile all'impresa.
+  Target: 14 minuti, 27 deliverable, 4 destinatari (cliente, comune, impresa, studio).
+
+# ============================================================================
+# Phases
+# ============================================================================
+
+phases:
+
+  # --------------------------------------------------------------------------
+  # PHASE 0: Initialization
+  # --------------------------------------------------------------------------
+  - id: phase_0_init
+    name: Inizializzazione
+    duration_target_seconds: 30
+    agent: "@progetto-chief"
+    actions:
+      - create_pm_squad_executions_row
+      - load_input_files
+      - validate_environment    # supabase service_role, file system access
+    blocks_next_phase: true
+
+  # --------------------------------------------------------------------------
+  # PHASE 1: Audit input
+  # --------------------------------------------------------------------------
+  - id: phase_1_audit
+    name: Audit input
+    duration_target_seconds: 90
+    agent: "@auditor-input"
+    blocks_next_phase: true
+    veto_conditions:
+      - input_validation_failed
+      - critical_data_missing
+    on_reject:
+      action: halt_and_ask_pablo
+      message: "Input incompleto: {missing_items}"
+
+  # --------------------------------------------------------------------------
+  # PHASE 2: Tier 1 esecuzione parallela (11 agenti)
+  # --------------------------------------------------------------------------
+  - id: phase_2_tier1_parallel
+    name: Esecuzione tecnica parallela
+    duration_target_seconds: 540   # 9 minuti
+    parallel: true
+    parallel_agents:
+      - id: a1
+        agent: "@briefing-architect"
+        depends_on_phase_1: true
+        depends_on_extracted_data: ["briefing"]
+        timeout_seconds: 90
+
+      - id: a2
+        agent: "@regolatorio-it"
+        depends_on: [a1]   # ha bisogno di brief-strutturato.json
+        timeout_seconds: 120
+
+      - id: a3
+        agent: "@concept-designer"
+        depends_on: [a1]
+        timeout_seconds: 300   # render gargalo
+
+      - id: a4
+        agent: "@cad-engineer"
+        depends_on: [a1]
+        timeout_seconds: 180
+
+      - id: a5
+        agent: "@bim-engineer"
+        depends_on: [a4]
+        timeout_seconds: 180
+
+      - id: a6
+        agent: "@computo-engineer"
+        depends_on: [a5]   # ha bisogno di quantitativi.json
+        timeout_seconds: 120
+
+      - id: a7
+        agent: "@capitolato-writer"
+        depends_on: [a6, a2]
+        timeout_seconds: 180
+
+      - id: a8
+        agent: "@pratiche-it"
+        depends_on: [a2, a4]
+        timeout_seconds: 120
+
+      - id: a9
+        agent: "@contratto-architect"
+        depends_on_phase_1: true
+        timeout_seconds: 90
+
+      - id: a10
+        agent: "@energy-prelim"
+        depends_on: [a4, a5, a6]
+        timeout_seconds: 120
+
+      - id: a11
+        agent: "@deliverable-builder"
+        depends_on: [a3, a4, a5, a6, a7, a8, a9, a10]   # ultimo, consolidatore — attende TUTTI i produttori di file (concept, CAD, BIM/IFC, computo, capitolato, pratiche, contratto, APE)
+        timeout_seconds: 90
+
+    on_agent_timeout: retry_once_then_escalate
+    on_agent_error: retry_once_then_escalate
+    blocks_next_phase: true
+
+  # --------------------------------------------------------------------------
+  # PHASE 3: Tier 2 QA parallelo (4 agenti)
+  # --------------------------------------------------------------------------
+  - id: phase_3_qa_parallel
+    name: Conferenza qualità
+    duration_target_seconds: 90
+    parallel: true
+    parallel_agents:
+      - agent: "@quality-misure"
+        verifies: ["@cad-engineer", "@bim-engineer"]
+
+      - agent: "@quality-normativa"
+        verifies: ["@regolatorio-it", "@capitolato-writer", "@pratiche-it", "@contratto-architect"]
+
+      - agent: "@quality-dati"
+        verifies: all_tier_1_outputs
+
+      - agent: "@quality-output"
+        verifies: deliverables_completeness
+
+    on_qa_reject:
+      action: route_to_phase_2_retry
+      retry_logic:
+        max_retries: 3
+        per_agent: true
+        if_max_reached: escalate_to_pablo
+    blocks_next_phase: true
+
+  # --------------------------------------------------------------------------
+  # PHASE 4: Consolidation
+  # --------------------------------------------------------------------------
+  - id: phase_4_consolidate
+    name: Consolidamento dossier
+    duration_target_seconds: 60
+    agent: "@progetto-chief"
+    actions:
+      - generate_readme_index
+      - create_dossier_zip
+      - upload_all_to_lovarch_storage
+      - insert_pm_documents_rows
+      - generate_manifest_with_sha256
+      - git_commit_with_tag
+      - mark_pm_squad_executions_status_completed
+      - open_finder
+      - print_final_summary
+
+  # --------------------------------------------------------------------------
+  # PHASE 5: Reveal (per palestra)
+  # --------------------------------------------------------------------------
+  - id: phase_5_reveal
+    name: Reveal in palco
+    optional: true
+    duration_target_seconds: 30
+    actions:
+      - print_url_to_terminal: "https://lovarch.com/admin/squad-execution/{execution_id}/dossier"
+      - say_to_pablo: "Dossier pronto. URL aperto."
+
+# ============================================================================
+# Performance targets
+# ============================================================================
+
+targets:
+  total_duration_seconds: 840   # 14 min
+  parallel_max: 8
+  qa_retry_max: 3
+  deliverables_min: 25   # soglia minima; target tipico = 27 (config deliverables_count)
+
+# ============================================================================
+# Failure modes
+# ============================================================================
+
+failure_modes:
+  audit_reject:
+    severity: blocking
+    action: ask_pablo
+
+  agent_timeout_x3:
+    severity: blocking
+    action: escalate_to_pablo
+
+  qa_reject_x3:
+    severity: blocking
+    action: escalate_to_pablo
+    log: full_diff_history
+
+  storage_quota:
+    severity: critical
+    action: halt_immediately
+    notify: pablo
+
+  api_5xx_persistent:
+    severity: blocking
+    action: pause_60s_retry_3x_then_escalate
+
+# ============================================================================
+# Realtime tracking
+# ============================================================================
+
+tracking:
+  table: pm_squad_steps
+  insert_on:
+    - agent_start
+    - agent_complete
+    - qa_verdict
+    - retry_initiated
+  update_on:
+    - status_change
+    - output_files_added
+  publish_realtime: true

lovarch_cli/squad_loader.py

@@ -0,0 +1,114 @@
+"""Resolve which squad payload directory the CLI should use at runtime.
+
+Three resolution sources, in priority order:
+
+1. Explicit override (CLI flag `--squad-src`) — highest priority. Used for
+   ad-hoc one-off runs against a custom squad path.
+2. `LOVARCH_SQUAD_SRC` environment variable — for the developer's daily
+   loop. Export once in `~/.zshrc` and every CLI invocation picks it up.
+3. Bundled `lovarch_cli/squad/` — the vendored snapshot shipped with the
+   package. This is what `brew install` users get.
+
+The override paths MUST point at a directory that looks like the squad
+(must contain at minimum `scripts/pipeline_runner.py` and `agents/`).
+We validate the shape early so the failure message is actionable instead
+of a cryptic FileNotFoundError two layers deeper.
+
+This module is the single source-of-truth for squad path resolution. All
+commands that read squad assets (run, init --sample, future dev tooling)
+go through `resolve_squad_root()`.
+"""
+from __future__ import annotations
+
+import os
+from pathlib import Path
+
+
+# Environment variable name. Document this widely — it's the daily dev
+# override most contributors will use.
+ENV_VAR = "LOVARCH_SQUAD_SRC"
+
+# Bundled vendor — shipped with the wheel via the build hook
+# (scripts/sync_squad.py). See docs/squad-vendoring.md.
+_BUNDLED_DIR: Path = Path(__file__).resolve().parent / "squad"
+
+# Shape markers — files we expect to find in any valid squad payload.
+# `scripts/pipeline_runner.py` is the orchestration entrypoint that
+# `lovarch run` shells out to. `agents/` is the directory of agent prompts.
+_REQUIRED_MARKERS: tuple[str, ...] = (
+    "scripts/pipeline_runner.py",
+    "agents",
+)
+
+
+class SquadNotFoundError(RuntimeError):
+    """The configured squad root does not exist or does not look like a squad."""
+
+
+def _looks_like_squad(path: Path) -> bool:
+    """Return True if every marker in _REQUIRED_MARKERS exists under path."""
+    return all((path / marker).exists() for marker in _REQUIRED_MARKERS)
+
+
+def _validate_or_raise(path: Path, source_label: str) -> Path:
+    """Raise SquadNotFoundError unless `path` looks like a valid squad payload."""
+    if not path.is_dir():
+        raise SquadNotFoundError(
+            f"Squad path from {source_label} does not exist or is not a "
+            f"directory: {path}"
+        )
+    if not _looks_like_squad(path):
+        missing = [m for m in _REQUIRED_MARKERS if not (path / m).exists()]
+        raise SquadNotFoundError(
+            f"Squad path from {source_label} is missing required files: "
+            f"{', '.join(missing)} (looked under {path})"
+        )
+    return path
+
+
+def resolve_squad_root(override: str | os.PathLike[str] | None = None) -> Path:
+    """Return the directory the CLI should treat as the squad payload root.
+
+    Priority:
+        1. `override` argument (typically wired from `--squad-src` flag)
+        2. `LOVARCH_SQUAD_SRC` env var
+        3. Bundled `lovarch_cli/squad/`
+
+    Raises:
+        SquadNotFoundError if no source resolves to a valid squad shape.
+    """
+    if override is not None:
+        candidate = Path(override).expanduser().resolve()
+        return _validate_or_raise(candidate, "--squad-src flag")
+
+    env_path = os.environ.get(ENV_VAR)
+    if env_path:
+        candidate = Path(env_path).expanduser().resolve()
+        return _validate_or_raise(candidate, f"${ENV_VAR}")
+
+    if _BUNDLED_DIR.is_dir() and any(_BUNDLED_DIR.iterdir()):
+        return _validate_or_raise(_BUNDLED_DIR, "bundled vendor")
+
+    raise SquadNotFoundError(
+        "No squad payload available. Bundled directory is empty and no "
+        f"override was provided. Set ${ENV_VAR} to a squad source path, "
+        "or pass --squad-src, or reinstall lovarch-cli."
+    )
+
+
+def squad_source_label(squad_root: Path) -> str:
+    """Return a short human-readable label for where this path came from.
+
+    Used by `lovarch dev show-squad-root` and run-summary panels.
+    """
+    if squad_root == _BUNDLED_DIR.resolve():
+        return "bundled"
+    env_path = os.environ.get(ENV_VAR)
+    if env_path and Path(env_path).expanduser().resolve() == squad_root:
+        return f"override (${ENV_VAR})"
+    return "override (flag)"
+
+
+def bundled_squad_dir() -> Path:
+    """Public accessor for the bundled vendor path — used by refresh tooling."""
+    return _BUNDLED_DIR

lovarch_cli/verify/__init__.py

@@ -0,0 +1,15 @@
+"""`lovarch verifica` — data-checking workflows for architects, interior
+designers, geometri and engineers.
+
+Design (Onda 2 · F10): deterministic code first (cheap, exact — ezdxf/regex),
+LLM only where judgment is needed, using the ADVERSARIAL two-model pattern:
+Sonnet 5 (executor) extracts/structures → Opus 4.8 (verifier) tries to refute
+each claim independently. Credits are debited per real tokens via cli-ai-text;
+deterministic checks are free.
+"""
+from lovarch_cli.verify.contratto import verify_contratto
+from lovarch_cli.verify.dossier import verify_dossier
+from lovarch_cli.verify.misure import verify_misure
+from lovarch_cli.verify.normativa import verify_normativa
+
+__all__ = ["verify_contratto", "verify_dossier", "verify_misure", "verify_normativa"]

lovarch_cli/verify/contratto.py

@@ -0,0 +1,110 @@
+"""verifica contratto — adversarial check of an architect's contract.
+
+Same two-model pattern as normativa: Sonnet 5 (executor) extracts the
+contract's structure, Opus 4.8 (verifier) adversarially checks it against the
+CNAPPC standard (12 articles) and the compenso rules — including the QN_007
+nuance: for a PRIVATE consumer client the DM 17/06/2016 parameters are
+ORIENTATIVE (an unexplained gap is a CONCERN, never an illegality; L.49/2023
+binds only strong counterparties such as PA/banks/large companies).
+"""
+from __future__ import annotations
+
+import json
+from dataclasses import dataclass, field
+from typing import Any
+
+from lovarch_cli.verify.normativa import NormativaError, _parse_json, extract_text
+
+CNAPPC_ARTICLES = [
+    "oggetto dell'incarico", "prestazioni professionali", "compenso",
+    "modalità di pagamento", "spese e oneri", "tempi di esecuzione",
+    "recesso", "inadempimento", "proprietà intellettuale",
+    "privacy/GDPR", "controversie/foro", "firma delle parti",
+]
+
+_EXTRACT_SYSTEM = (
+    "Sei un assistente per contratti di prestazione professionale di "
+    "architettura (standard CNAPPC). Estrai dal contratto la struttura: quali "
+    "delle 12 sezioni tipiche sono presenti, il tipo di committente "
+    "(privato consumatore | PA | impresa | banca/assicurazione), il compenso "
+    "pattuito e come è giustificato. Rispondi SOLO con JSON valido: "
+    '{"sections_present": ["..."], "sections_missing": ["..."], '
+    '"client_type": "privato|pa|impresa|banca|sconosciuto", '
+    '"compenso": {"amount": "...", "justification": "... o null"}, '
+    '"notes": ["..."]}'
+)
+
+_REFUTE_SYSTEM = (
+    "Sei un verificatore ADVERSARIALE di contratti CNAPPC. Controlla: "
+    "(1) completezza delle 12 sezioni tipiche; (2) coerenza del compenso. "
+    "REGOLA COMPENSO (QN_007): per un committente PRIVATO CONSUMATORE i "
+    "parametri DM 17/06/2016 sono ORIENTATIVI — uno scostamento non motivato è "
+    "un CONCERN (mai una violazione di legge, la L.49/2023 vincola solo "
+    "contraenti forti: PA, banche, assicurazioni, grandi imprese); per un "
+    "contraente FORTE lo scostamento sotto i parametri è invece violazione. "
+    "Rispondi SOLO con JSON valido: "
+    '{"findings": [{"area": "...", "severity": "critical" | "concern" | "info", '
+    '"reason": "..."}], "overall": "PASS" | "CONCERNS" | "REJECT"}'
+)
+
+
+@dataclass
+class ContrattoReport:
+    verdict: str
+    structure: dict = field(default_factory=dict)
+    findings: list[dict] = field(default_factory=list)
+    credits_charged: int = 0
+
+
+async def verify_contratto(
+    gateway: Any,
+    document_path: str,
+    *,
+    language: str = "it",
+    max_chars: int = 60_000,
+) -> ContrattoReport:
+    """Adversarial CNAPPC contract check. Debits credits (2 calls)."""
+    text = extract_text(document_path)
+    if not text.strip():
+        raise NormativaError("documento vuoto o testo non estraibile.")
+    if len(text) > max_chars:
+        text = text[:max_chars]
+
+    credits = 0
+    extraction = await gateway.generate_text(
+        f"CONTRATTO:\n\n{text}",
+        role="executor",
+        system=_EXTRACT_SYSTEM,
+        max_tokens=1500,
+        language=language,
+        operation_type="verify:contratto:extract",
+    )
+    credits += extraction.credits_charged
+    structure = _parse_json(extraction.text)
+
+    refutation = await gateway.generate_text(
+        "STRUTTURA ESTRATTA DAL CONTRATTO:\n\n"
+        + json.dumps(structure, ensure_ascii=False)
+        + "\n\nSezioni CNAPPC attese: " + ", ".join(CNAPPC_ARTICLES),
+        role="verifier",
+        system=_REFUTE_SYSTEM,
+        max_tokens=2000,
+        language=language,
+        operation_type="verify:contratto:refute",
+    )
+    credits += refutation.credits_charged
+    judged = _parse_json(refutation.text)
+    findings = judged.get("findings") or []
+
+    overall = str(judged.get("overall", "")).upper()
+    if overall not in ("PASS", "CONCERNS", "REJECT"):
+        severities = [str(f.get("severity", "")).lower() for f in findings]
+        overall = ("REJECT" if "critical" in severities
+                   else ("CONCERNS" if "concern" in severities else "PASS"))
+
+    return ContrattoReport(
+        verdict=overall,
+        structure=structure,
+        findings=findings,
+        credits_charged=credits,
+    )

lovarch_cli/verify/dossier.py

@@ -0,0 +1,97 @@
+"""verifica dossier — run the full standalone QA over a deliverables folder.
+
+Composes the individual verifiers by file type:
+  *.dxf                → misure (deterministic, free)
+  contratto*.{pdf,md}  → contratto (adversarial, credits)
+  other *.{pdf,md,txt} → normativa (adversarial, credits)
+
+Verdict aggregation mirrors the squad's Tier-2 rule: any REJECT → REJECT;
+any CONCERNS → CONCERNS; else PASS.
+"""
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Any
+
+from lovarch_cli.verify.contratto import verify_contratto
+from lovarch_cli.verify.misure import verify_misure
+from lovarch_cli.verify.normativa import NormativaError, verify_normativa
+
+_TEXT_SUFFIXES = {".pdf", ".md", ".txt"}
+
+
+@dataclass
+class DossierReport:
+    verdict: str
+    files: list[dict] = field(default_factory=list)   # per-file {name, kind, verdict, detail}
+    credits_charged: int = 0
+    skipped: list[str] = field(default_factory=list)
+
+
+async def verify_dossier(
+    gateway: Any,
+    directory: str | Path,
+    *,
+    language: str = "it",
+    max_llm_files: int = 8,
+) -> DossierReport:
+    """Verify every recognized deliverable in a folder.
+
+    ``max_llm_files`` caps how many documents go through the paid adversarial
+    checks in one run (DXF checks are free and uncapped) — the cap and any
+    skipped files are reported explicitly, never silently.
+    """
+    root = Path(directory).expanduser()
+    if not root.is_dir():
+        raise NormativaError(f"cartella non trovata: {root}")
+
+    files: list[dict] = []
+    skipped: list[str] = []
+    credits = 0
+    llm_used = 0
+
+    entries = sorted(p for p in root.rglob("*") if p.is_file())
+    for path in entries:
+        suffix = path.suffix.lower()
+        rel = str(path.relative_to(root))
+        if suffix == ".dxf":
+            report = verify_misure(path)
+            files.append({
+                "name": rel, "kind": "misure", "verdict": report.verdict,
+                "detail": "; ".join(report.findings) or "ok",
+            })
+        elif suffix in _TEXT_SUFFIXES:
+            if llm_used >= max_llm_files:
+                skipped.append(rel)
+                continue
+            llm_used += 1
+            is_contract = "contratto" in path.name.lower() or "contract" in path.name.lower()
+            try:
+                if is_contract:
+                    rep = await verify_contratto(gateway, str(path), language=language)
+                    detail = "; ".join(
+                        f"[{f.get('severity')}] {f.get('area')}" for f in rep.findings[:4]
+                    ) or "ok"
+                else:
+                    rep = await verify_normativa(gateway, str(path), language=language)
+                    detail = "; ".join(
+                        f"{v.get('reference')}: {v.get('status')}" for v in rep.verdicts[:4]
+                    ) or "; ".join(rep.notes) or "ok"
+                credits += rep.credits_charged
+                files.append({
+                    "name": rel, "kind": "contratto" if is_contract else "normativa",
+                    "verdict": rep.verdict, "detail": detail,
+                })
+            except NormativaError as exc:
+                files.append({"name": rel, "kind": "errore", "verdict": "CONCERNS",
+                              "detail": str(exc)[:120]})
+
+    if not files:
+        raise NormativaError("nessun file verificabile trovato (.dxf/.pdf/.md/.txt).")
+
+    verdicts = [f["verdict"] for f in files]
+    overall = ("REJECT" if "REJECT" in verdicts
+               else ("CONCERNS" if "CONCERNS" in verdicts or skipped else "PASS"))
+    return DossierReport(verdict=overall, files=files,
+                         credits_charged=credits, skipped=skipped)

lovarch_cli/verify/misure.py

@@ -0,0 +1,83 @@
+"""verifica misure — deterministic DXF checks (UNI ISO 5457 / CNAPPC).
+
+Ported from the squad's Tier-2 @quality-misure verifier (pipeline_runner Q1) so
+any professional can check a drawing standalone, without running the dossier.
+Pure code — no credits are consumed.
+"""
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from pathlib import Path
+
+ISO_LAYERS = {
+    "CAD-A-WALL", "CAD-A-WALL-EXT", "CAD-A-DOOR", "CAD-A-WIND", "CAD-A-DIM",
+    "CAD-A-TEXT", "CAD-A-SYMB", "CAD-A-FURN", "CAD-A-CART",
+}
+ROOM_LABELS = {"INGRESSO", "SOGGIORNO", "CUCINA", "STUDIO", "CAMERA", "BAGNO", "LAVANDERIA"}
+CARTIGLIO_REQUIRED = ["PROGETTO", "CLIENTE", "ARCHITETTO", "SCALA", "DATA"]
+
+
+@dataclass
+class MisureReport:
+    verdict: str                 # PASS | CONCERNS | REJECT
+    findings: list[str] = field(default_factory=list)
+    stats: dict = field(default_factory=dict)
+
+
+def verify_misure(dxf_path: str | Path) -> MisureReport:
+    """Check a DXF for ISO layer compliance, room labels and CNAPPC cartiglio."""
+    path = Path(dxf_path).expanduser()
+    findings: list[str] = []
+    stats: dict = {}
+
+    if not path.is_file():
+        return MisureReport(verdict="REJECT", findings=[f"file non trovato: {path}"])
+
+    try:
+        import ezdxf
+        doc = ezdxf.readfile(str(path))
+    except Exception as exc:  # noqa: BLE001 — parse errors are the finding
+        return MisureReport(verdict="REJECT", findings=[f"DXF non leggibile: {str(exc)[:120]}"])
+
+    msp = doc.modelspace()
+    layers = {e.dxf.layer for e in msp}
+    stats["entities"] = len(msp)
+    stats["layers"] = sorted(layers)
+
+    # 1. ISO layer compliance (UNI ISO 5457 naming convention)
+    iso_ok = ISO_LAYERS & layers
+    stats["iso_layers_present"] = len(iso_ok)
+    if len(iso_ok) < 6:
+        findings.append(
+            f"conformità layer ISO: solo {len(iso_ok)}/9 layer standard presenti "
+            f"(attesi: {', '.join(sorted(ISO_LAYERS - layers))} mancanti)"
+        )
+
+    # 2. Room labels
+    texts = [e for e in msp if e.dxftype() in ("TEXT", "MTEXT")]
+    rooms: set[str] = set()
+    for e in texts:
+        try:
+            t = (e.dxf.text if e.dxftype() == "TEXT" else e.text).upper()
+        except Exception:  # noqa: BLE001
+            continue
+        for room in ROOM_LABELS:
+            if room in t:
+                rooms.add(room)
+    stats["room_labels_found"] = sorted(rooms)
+    missing_rooms = ROOM_LABELS - rooms
+    if len(missing_rooms) > 1:
+        findings.append(f"etichette ambienti mancanti: {', '.join(sorted(missing_rooms))}")
+
+    # 3. Cartiglio CNAPPC
+    cart_text = " ".join(
+        (e.dxf.text if e.dxftype() == "TEXT" else e.text).upper()
+        for e in texts
+        if "CART" in str(e.dxf.layer).upper()
+    )
+    cart_missing = [k for k in CARTIGLIO_REQUIRED if k not in cart_text]
+    if cart_missing:
+        findings.append(f"cartiglio CNAPPC incompleto: mancano {', '.join(cart_missing)}")
+
+    verdict = "PASS" if not findings else ("CONCERNS" if len(findings) == 1 else "REJECT")
+    return MisureReport(verdict=verdict, findings=findings, stats=stats)