lovarch-cli 0.2.1__py3-none-any.whl

lovarch_cli/squad/config.yaml

@@ -0,0 +1,408 @@
+pack:
+  name: architettura-progetto
+  version: 2.0.0
+  short-title: Squad Architettura Progetto
+  description: >-
+    Squad specialistico per esecuzione end-to-end di progetti architettonici
+    italiani: dal briefing del cliente al dossier consegnabile all'impresa.
+    17 agenti in 4 tier con 7 mind clones di elite minds (Deming, Juran, English,
+    Dodds, Schumacher, Baldwin, Mazria) e 10 agenti funzionali. Doppia verifica
+    qualità (misure + dati + normativa + output) con loop di retrabalho automatico.
+    Focus: accuratezza millimetrica, conformità normativa IT, zero reinvenzione.
+  author: ArchPrime Team · Lovarch
+  icon: "\U0001F3DB"
+  slashPrefix: architetturaProgetto
+  entry_agent: progetto-chief
+  tested: true
+  updated_at: "2026-04-25"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# PATTERN LIBRARY (AP-* prefix)
+# ═══════════════════════════════════════════════════════════════════════════════
+pattern_library:
+  prefix: AP
+  naming_convention:
+    format: "{PREFIX}-{CATEGORY}-{NUMBER}"
+    example: "AP-TP-001"
+  categories:
+    - id: TP
+      name: "Task Patterns"
+      description: "Patterns for architectural project task execution"
+    - id: EP
+      name: "Executor Patterns"
+      description: "Patterns for executor selection (worker vs agent vs hybrid vs human)"
+    - id: PP
+      name: "Process Patterns"
+      description: "Patterns for project workflow phases"
+    - id: QP
+      name: "Quality Patterns"
+      description: "Patterns for QA validation (misure, normativa, dati, output)"
+    - id: NP
+      name: "Normative Patterns"
+      description: "Patterns for Italian regulatory compliance"
+    - id: BP
+      name: "BIM Patterns"
+      description: "Patterns for BIM/CAD/IFC processing"
+  patterns:
+    - id: AP-TP-001
+      name: "Atomic Task Anatomy"
+      description: "8 mandatory fields: name, status, executor, type, input, output, action_items, acceptance_criteria"
+    - id: AP-PP-001
+      name: "Hub-and-Spoke Handoff"
+      description: "All agent handoffs route through @progetto-chief, never directly between specialists"
+    - id: AP-QP-001
+      name: "Triple-Pass Quality Gate"
+      description: "Every Tier 1 output passes through min 2 of 4 QA agents (misure, normativa, dati, output)"
+    - id: AP-QP-002
+      name: "Reject-Retry Loop"
+      description: "QA REJECT routes back to originating agent with diff (max 3 retries, then escalate)"
+    - id: AP-NP-001
+      name: "Italian Regulatory Stack"
+      description: "DPR 380 + UNI 11337 + CAM 2025 + NTC 2018 + D.Lgs 81 mandatory references"
+    - id: AP-BP-001
+      name: "DXF UNI ISO 5457 Compliance"
+      description: "Layer ISO standard, cotazioni ±1mm, cartiglio CNAPPC obbligatori"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# TASK STANDARDS
+# ═══════════════════════════════════════════════════════════════════════════════
+task_standards:
+  enforce_anatomy: true
+  validator: "AP-TP-001"
+  required_fields:
+    - task_name
+    - status
+    - responsible_executor
+    - execution_type
+    - input
+    - output
+    - action_items
+    - acceptance_criteria
+  optional_fields:
+    - estimated_time
+    - dependencies
+    - templates
+    - quality_gate
+    - handoff
+    - veto_conditions
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# EXECUTOR TYPES
+# ═══════════════════════════════════════════════════════════════════════════════
+executor_types:
+  human:
+    id: "AP-EP-001"
+    name: "Human Executor"
+    use_for:
+      - "Firma digitale qualificata (eIDAS QES)"
+      - "Calcolo strutturale certificato (NTC 2018)"
+      - "Rilievo metrico topografico"
+      - "Coordinatore Sicurezza CSP/CSE"
+      - "Approvazione progettuale finale del cliente"
+      - "Firma asseverazione del professionista abilitato"
+  agent:
+    id: "AP-EP-002"
+    name: "Agent Executor (AI)"
+    use_for:
+      - "Brief structuring (UNI 11337)"
+      - "Concept design (moodboard, render)"
+      - "Capitolato writing (UNI 11337-7)"
+      - "Computo metrico estimativo (Prezzario Lombardia)"
+      - "Pratiche pre-compilation (CILA, SCIA)"
+      - "Quality verification (misure, normativa, dati, output)"
+  hybrid:
+    id: "AP-EP-003"
+    name: "Hybrid Executor"
+    use_for:
+      - "Regolamentare verification (AI + human validation)"
+      - "Capitolato review (AI 80% + BIM Manager 20%)"
+      - "APE preliminare (AI estimate + ingegnere energetico firma)"
+      - "Contratto generation (AI + cliente firma)"
+  worker:
+    id: "AP-EP-004"
+    name: "Worker Executor"
+    use_for:
+      - "DXF generation via ezdxf"
+      - "IFC validation via ifcopenshell"
+      - "PDF rendering via ReportLab/WeasyPrint"
+      - "Excel generation via xlsxwriter"
+      - "Geocoding via Mapbox API"
+      - "ZIP packaging final dossier"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# WORKFLOW CONFIGURATION
+# ═══════════════════════════════════════════════════════════════════════════════
+workflow_config:
+  checkpoint_policy: always_active
+  fail_fast: true
+  allow_manual_override: false
+  qa_retry_max: 3
+  parallelization_max: 8
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# AGENTS · 17 in 4 tiers (1 chief + 1 input gate + 11 Tier 1 + 4 Tier 2 QA)
+# ═══════════════════════════════════════════════════════════════════════════════
+agents:
+  # Tier 0: Orchestration
+  - id: progetto-chief
+    name: Progetto Chief
+    tier: 0
+    role: Orchestrator & Italian Architectural Project Knowledge Hub
+    type: functional
+
+  - id: auditor-input
+    name: Auditor Input
+    tier: 0
+    role: Pre-flight Input Gate Validator
+    type: functional
+
+  # Tier 1: Technical Execution (11 agents)
+  - id: briefing-architect
+    name: Briefing Architect
+    tier: 1
+    role: Brief Structuring (UNI 11337 / LOIN EN 17412-1)
+    type: functional
+
+  - id: regolatorio-it
+    name: Regolatorio IT
+    tier: 1
+    role: Italian Regulatory Compliance (DPR 380, D.Lgs 42, PRG)
+    type: functional
+
+  - id: concept-designer
+    name: Concept Designer
+    tier: 1
+    role: Visual Concept (Moodboard, Palette, Render FLUX)
+    type: mind_clone
+    based_on: "Patrik Schumacher (ZHA) — AI architectural ideation pioneer"
+
+  - id: cad-engineer
+    name: CAD Engineer
+    tier: 1
+    role: 2D Quotated Plans (UNI ISO 5457, ezdxf)
+    type: functional
+    critical: misure_zero_tolerance
+
+  - id: bim-engineer
+    name: BIM Engineer
+    tier: 1
+    role: BIM/IFC4 LOD 300 Modeling
+    type: mind_clone
+    based_on: "Mark Baldwin — BIM Manager's Handbook author"
+
+  - id: computo-engineer
+    name: Computo Engineer
+    tier: 1
+    role: Quantity Take-off + Prezzario Lombardia
+    type: functional
+    critical: dati_zero_tolerance
+
+  - id: capitolato-writer
+    name: Capitolato Writer
+    tier: 1
+    role: Capitolato Speciale d'Appalto (UNI 11337-7 + CAM 2025)
+    type: functional
+
+  - id: pratiche-it
+    name: Pratiche IT
+    tier: 1
+    role: CILA/SCIA/Paesaggistica Pre-compilation
+    type: functional
+    requires_human_signature: true
+
+  - id: contratto-architect
+    name: Contratto Architect
+    tier: 1
+    role: Contratto CNAPPC + Equo Compenso L.49/2023
+    type: functional
+
+  - id: energy-prelim
+    name: Energy Preliminary
+    tier: 1
+    role: APE Preliminare + LCA Embodied Carbon
+    type: mind_clone
+    based_on: "Edward Mazria — Architecture 2030 founder"
+
+  - id: deliverable-builder
+    name: Deliverable Builder
+    tier: 1
+    role: Final Deliverables (Presentation, Portal, ZIP)
+    type: functional
+
+  # Tier 2: Quality Assurance (4 mind clones)
+  - id: quality-misure
+    name: Quality Misure
+    tier: 2
+    role: Measurement Verification (±1mm tolerance)
+    type: mind_clone
+    based_on: "W. Edwards Deming — Total Quality Management"
+
+  - id: quality-normativa
+    name: Quality Normativa
+    tier: 2
+    role: Italian Normative Compliance Verification
+    type: mind_clone
+    based_on: "Joseph Juran — Quality Trilogy"
+
+  - id: quality-dati
+    name: Quality Dati
+    tier: 2
+    role: Cross-Document Data Coherence
+    type: mind_clone
+    based_on: "Larry English — Information Quality"
+
+  - id: quality-output
+    name: Quality Output
+    tier: 2
+    role: Deliverable Completeness + Behavior Testing
+    type: mind_clone
+    based_on: "Kent C. Dodds — Testing Trophy"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# CENTRAL DOCUMENT (mandatory consultation)
+# ═══════════════════════════════════════════════════════════════════════════════
+central_document:
+  path: "data/architettura-progetto-rules.md"
+  rule: "ALL agents MUST consult this document before any action"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# CHANGELOG
+# ═══════════════════════════════════════════════════════════════════════════════
+changelog:
+  path: "data/CHANGELOG.md"
+  rule: "ALL agents MUST update this file after completing any project execution"
+  consult: "Read before acting to understand recent project executions"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# HANDOFF PROTOCOL · Hub-and-Spoke (mandatory)
+# ═══════════════════════════════════════════════════════════════════════════════
+handoff_protocol:
+  topology: hub_and_spoke
+  hub: "@progetto-chief"
+  critical_rule: >
+    Specialists NEVER chain directly to other specialists. EVERY handoff returns
+    to @progetto-chief, who validates output via handoff-quality-gate and routes
+    the next step. Quality agents (Tier 2) are MANDATORY between Tier 1 and consolidation.
+  artifact: "data/handoff-card-template.md"
+  quality_gate: "checklists/handoff-quality-gate.md"
+  status_machine:
+    states: [Triaged, Routed, InProgress, Returned, Validated, QA_Pending, QA_Pass, QA_Reject, Done]
+    transitions:
+      Triaged_to_Routed: "@progetto-chief"
+      Routed_to_InProgress: "specialist (on receipt)"
+      InProgress_to_Returned: "specialist (with announcement)"
+      Returned_to_QA_Pending: "@progetto-chief routes to applicable QA agent(s)"
+      QA_Pending_to_QA_Pass: "QA agent (verdict PASS)"
+      QA_Pending_to_QA_Reject: "QA agent (verdict REJECT)"
+      QA_Reject_to_InProgress: "originating specialist (retry, max 3)"
+      QA_Pass_to_Validated: "@progetto-chief"
+      Validated_to_Done: "@progetto-chief (after consolidation + Lovarch upload)"
+  required_announcement_format: "Ritorno al @progetto-chief. {esito}."   # prefisso obbligatorio in italiano + esito conciso (es. 'verdict PASS', 'cotazioni verificate')
+  enforcement:
+    - "Specialists without handoff_to: @progetto-chief as primary → BLOCKED"
+    - "Output without announcement → REJECTED, returned to specialist"
+    - "Specialist routing directly to another specialist → VETO"
+    - "Tier 1 output skipping Tier 2 QA → VETO"
+    - "QA REJECT after 3 retries → ESCALATE to human (Pablo)"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# QUALITY GATES REFERENCE
+# ═══════════════════════════════════════════════════════════════════════════════
+quality_gates:
+  blocking:
+    - id: "QG-AP-1.1"
+      name: "Input Validation Gate"
+      executor: "@auditor-input"
+      checks: 18
+      blocks: "Workflow start"
+    - id: "QG-AP-1.2"
+      name: "Misure Verification Gate"
+      executor: "@quality-misure"
+      checks: 24
+      blocks: "Tier 1 → consolidation"
+    - id: "QG-AP-1.3"
+      name: "Normativa Verification Gate"
+      executor: "@quality-normativa"
+      checks: 18
+      blocks: "Tier 1 → consolidation"
+    - id: "QG-AP-1.4"
+      name: "Cross-Doc Data Gate"
+      executor: "@quality-dati"
+      checks: 16
+      blocks: "Tier 1 → consolidation"
+    - id: "QG-AP-1.5"
+      name: "Output Completeness Gate"
+      executor: "@quality-output"
+      checks: 14
+      blocks: "Final delivery"
+  validation_command: "python3 squads/architettura-progetto/scripts/validate-squad.py"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# PERFORMANCE TARGETS
+# ═══════════════════════════════════════════════════════════════════════════════
+targets:
+  total_duration_max_seconds: 840
+  parallel_agents_max: 8
+  qa_retry_max: 3
+  deliverables_count: 27   # target tipico; minimo accettabile = 25 (vedi workflow deliverables_min)
+  tier1_parallel_start_second: 120
+  tier2_after_tier1: true
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# OUTPUT LANGUAGES
+# ═══════════════════════════════════════════════════════════════════════════════
+output_languages:
+  primary: it
+  secondary: [en, es, pt]
+  terminology_source: UNI 11337 + CNAPPC + ISO 5457
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# EXECUTION
+# ═══════════════════════════════════════════════════════════════════════════════
+execution:
+  mode: claude_code_local
+  chief_is_orchestrator: true
+  parallelization_tool: Task
+  state_persistence: pm_squad_steps_table
+  file_output_base: ~/projects/{project_slug}/
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# INTEGRATION · LOVARCH PLATFORM
+# ═══════════════════════════════════════════════════════════════════════════════
+integration:
+  supabase_tables:
+    - pm_squad_executions
+    - pm_squad_steps
+    - pm_squad_qa_checks
+  admin_pages:
+    - /admin/squad-execution/:id/live
+    - /admin/squad-execution/:id/dossier
+  edge_functions_used:
+    - moodboard-suggest
+    - render-ai-generate
+    - render-plan-to-3d
+    - colors-generate
+    - fonts-recommend
+    - brochure-generate
+    - brainstorm-generate
+    - calendar-generate
+    - portal-ai
+    - portal-auth
+    - ai-site-generate
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# EXTERNAL APIs
+# ═══════════════════════════════════════════════════════════════════════════════
+external_apis:
+  required_for_demo:
+    - mapbox_geocoding
+  required_for_production:
+    - openapi_com
+    - yousign_api
+    - deepl_pro
+    - meteostat
+    - ec3_building
+  optional:
+    - one_click_lca
+    - dei_plus_prezzario
+    - cubicasa

lovarch_cli/squad/data/CHANGELOG.md

@@ -0,0 +1,272 @@
+# Squad Architettura-Progetto · CHANGELOG
+
+> Cronologia di tutte le esecuzioni del squad e modifiche alla configurazione.
+> Mandatory: agents devono aggiungere entry dopo ogni esecuzione completa.
+> Format: reverse chronological (newest first).
+
+---
+
+## [2.2.0] — 2026-06-12 · QA gate fix · pipeline non marca COMPLETED con Tier 2 REJECT
+
+### Critical fix (Fase 1.2 del piano audit 12/06)
+`pipeline_runner.py` Phase D calcolava il verdetto Tier 2 (`_overall`) ma lo
+**ignorava** nel determinare lo stato finale: marcava `completed` finché non
+c'era un crash (`pipeline_error`). Un REJECT del QA (documentato nelle
+esecuzioni `52d9af10` e `6189721b`) veniva quindi marcato COMPLETED — l'aluno
+pagava crediti e riceveva un dossier respinto dal QA stesso. Violava
+`rules.md §1.2` e `config.yaml workflow_config.fail_fast: true`.
+
+**Parte A — guard qa_rejected:**
+- Nuovo stato terminale `qa_rejected` (precedenza: `failed` > `qa_rejected` > `completed`).
+- Quando Tier 2 OVERALL = REJECT → status `qa_rejected`, MAI `completed`.
+  Le 4 verifiche sono deterministiche per un dato set di deliverable, quindi un
+  REJECT vale come "esaurito dopo `QA_RETRY_MAX` (3) tentativi" invece di un
+  loop inutile.
+- Report leggibile per l'aluno (italiano) `QA-REJECT-report.pdf`: elenca quali
+  verifier hanno respinto e perché, + istruzioni e contatto supporto.
+- `escalate_to_pablo` (non eseguibile sulla macchina di un aluno) sostituito da
+  halt + messaggio chiaro + `LOVARCH_SUPPORT_EMAIL` (default info@lovarch.com).
+- Exit code propagato: `0` OK · `3` qa_rejected · `1` errore tecnico. Il CLI
+  `lovarch run` mappa l'exit code → `last_run.status` in project.yaml + pannello
+  dedicato (chiave i18n `run.qa_rejected` in 4 lingue).
+- `pm_squad_executions.metadata` ora include `qa_verdicts`, `qa_overall`,
+  `qa_attempts`, `qa_findings`, `qa_report_url`.
+
+**Parte B — cause reali dei REJECT corrette (decisione presa):**
+Indagine: NON esistono edge function dedicate per i 5 PDF Tier 1 (le ricerche
+in `supabase/functions/` per cila/capitolato/computo/contratto/asseverazione
+danno 0 risultati). La premessa del CHANGELOG ("PDF boilerplate, serve LLM")
+è una diagnosi parziale. Le cause reali dei REJECT sono bug di
+generatore/verifier, non povertà di contenuto:
+- **Q1 (misure) REJECT**: `gen_dxf_pianta_progetto` usava layer `MURI-NUOVI/PORTE/...`
+  mentre `@quality-misure` si aspetta layer ISO `CAD-A-*`; mancavano le room
+  label INGRESSO/SOGGIORNO/LAVANDERIA; il cartiglio era sul layer `TESTI` (non
+  `CAD-A-CART`). **Fix**: rinominati i layer in convenzione ISO `CAD-A-*`,
+  aggiunte tutte e 9 le room label canoniche, cartiglio su `CAD-A-CART` con i 5
+  campi CNAPPC (PROGETTO/CLIENTE/ARCHITETTO/SCALA/DATA). Verificato: Q1 → PASS.
+- **Q2 (normativa) REJECT 0/8**: il verifier leggeva i byte grezzi del PDF in
+  latin-1, ma ReportLab comprime i text stream (FlateDecode) → la regex non
+  trovava nulla anche con riferimenti presenti. **Fix**: estrazione testo reale
+  via `pypdf` quando disponibile, con fallback al raw-byte scan (nessuna nuova
+  dipendenza obbligatoria per il CLI). Verificato: refs DPR 380/UNI 11337/CAM/
+  NTC/D.Lgs 81 rilevati.
+
+L'enrichment LLM dei PDF resta backlog (vedi Fase 6.x): non era la causa del
+REJECT e wire-up speculativo avrebbe aggiunto rischio senza risolvere Q1/Q2.
+
+### File modificati
+- `scripts/pipeline_runner.py` (Phase D qa_rejected guard, report builder,
+  exit codes, Q2 pypdf extraction)
+- `scripts/deliverable_generators.py` (`gen_dxf_pianta_progetto`,
+  `gen_dxf_sezione` → layer ISO `CAD-A-*`)
+- lovarch-cli: `commands/run.py` (exit-code → status + `last_run`),
+  `i18n/translations/{en,it,pt,es}.json` (`run.qa_rejected`), `version.py` v0.1.2,
+  vendored `lovarch_cli/squad/scripts/{pipeline_runner,deliverable_generators}.py`
+
+---
+
+## Execution Log · 2026-04-25 · Mario Rossi demo (sample-input as-is, no rename)
+
+- **execution_id:** `6189721b-da28-402d-a101-83643976f4f5`
+- **project_id:** `b3d9b070-7a73-4db4-a353-fe2432188e3d` · Attico Brera (sample-input dataset · briefing intatto · cliente rimane Marco Rossini & Giulia Bianchi nei deliverable)
+- **runner:** `pipeline_runner.py v4` · `--real`
+- **invocato da:** `/architetturaProgetto Esegui il progetto al 100% per il cliente Mario Rossi. --real` (opzione 1 confermata da Pablo · etichetta "Mario Rossi" solo nel CHANGELOG/folder name, NON applicato sed sul codice)
+- **wall-clock:** 17 min 18s (target 14 min · oltrepassato di 3 min per renders i2i gpt-image-2 = 14:32 da soli, il resto in 2:46)
+- **deliverables totali:** 32 (4 moodboard imgs + 5 i2i renders + 26 documents)
+- **Tier 2 QA verdicts (real verifiers · 17 step rows in pm_squad_steps):**
+  - Q1 @quality-misure: **REJECT** (DXF programmatico · layer ISO/cartiglio incompleti)
+  - Q2 @quality-normativa: **REJECT 0/8** (DPR 380, UNI 11337, CAM 2025, NTC 2018, D.Lgs 81, D.Lgs 42, L.49/2023, GDPR · PDF stub `gen_pdf` boilerplate non contengono refs letterali)
+  - Q3 @quality-dati: **PASS** 32/32 HEAD 200 (upload Lovarch storage tutti integri)
+  - Q4 @quality-output: **CONCERNS** 13/14 AC (✗ AC2 5 renders count check)
+  - Tier 2 OVERALL: **REJECT** · Phase D ha proseguito (resilient pipeline · execution marked COMPLETED)
+- **URLs:**
+  - Live: https://lovarch.com/admin/squad-execution/6189721b-da28-402d-a101-83643976f4f5/live
+  - Dossier: https://lovarch.com/admin/squad-execution/6189721b-da28-402d-a101-83643976f4f5/dossier
+- **Insight (consistente con run precedente 52d9af10):** stessi verdicts Q1/Q2 REJECT confermano limite architetturale del runner v4 — i PDFs Tier 1 (CILA, capitolato, computo, contratto, asseverazione) sono generati da `gen_pdf` con testo template-driven, non LLM-content-rich. Verifiers reali (Q1 ezdxf parse · Q2 grep regulatory refs) li bocciano correttamente. Per produrre dossier veri serve sostituire `gen_pdf` boilerplate con chiamate edge function dedicate (capitolato-writer, pratiche-it, ecc.) — già definite come agenti, non ancora connesse al runner.
+
+---
+
+## Execution Log · 2026-04-25 · Mario Rossi (demo client rebrand · earlier run)
+
+- **execution_id:** `52d9af10-8a10-4595-bf64-24f2db2f1f6e`
+- **project_id:** `e2b213b1` · Attico Brera (sample-input dataset · client renamed Mario Rossi)
+- **runner:** `pipeline_runner.py v4` · `--real`
+- **wall-clock:** ~16 min (target 14 min · oltrepassato per latenza OpenAI gpt-image-2 sui 9 imgs)
+- **patches applicate:** sed `Marco Rossini → Mario Rossi` su `pipeline_runner.py` + `deliverable_generators.py` · revert post-execution via `.bak` · git status pulito
+- **deliverables totali:** 32 (4 moodboard imgs + 5 i2i renders + 3 DXF + 12 PDF + 4 XLSX + 2 JSON + 1 HTML + 6 foto + 6 pinterest)
+- **Tier 2 QA verdicts (real verifiers):**
+  - Q1 @quality-misure: **REJECT** (ezdxf parse pianta-progetto.dxf · layer ISO/cartiglio incompleti)
+  - Q2 @quality-normativa: **REJECT 0/8** (DPR 380, UNI 11337, CAM 2025, NTC 2018, D.Lgs 81, D.Lgs 42, L.49/2023, GDPR · stub PDFs ~2-3 KB non contengono refs)
+  - Q3 @quality-dati: **PASS** (HTTP HEAD storage URLs OK · pm_documents FK validi)
+  - Q4 @quality-output: **CONCERNS** (AC2 5 renders presenti · altre AC parziali)
+  - Tier 2 OVERALL: **REJECT** · pipeline resilient ha proseguito (Phase D ALWAYS runs)
+- **Phase D · Consolidation:** ✅ execution marked COMPLETED · browser auto-aperto su dossier + new-home
+- **URLs:**
+  - Live: https://lovarch.com/admin/squad-execution/52d9af10-8a10-4595-bf64-24f2db2f1f6e/live
+  - Dossier: https://lovarch.com/admin/squad-execution/52d9af10-8a10-4595-bf64-24f2db2f1f6e/dossier
+- **Insight:** verifiers reali stanno facendo il loro lavoro · espongono onestamente che i PDFs Tier 1 sono placeholder e non contengono articoli normativi reali. Patch nominale del cliente non altera il contenuto tecnico (CF/indirizzo/coniuge restano del demo Attico Brera).
+
+---
+
+## [2.1.0] — 2026-04-25 · Real Tier 2 QA + AP-VIOLATION-002 fix
+
+### Critical fix
+`pipeline_runner.py:1411-1441` `qa_agents` for-loop emitted hardcoded
+"PASS · 9/9 ambienti..." strings without verification. All 4 QA agents
+executed at identical timestamp (t=1070s) on execution 66db7c46, exposing
+the fake. This violates rules.md §1.2 ("Tier 2 QA mandatory · NEVER
+skips") and constitutional principle AP-VIOLATION-002.
+
+Replaced with 4 real verifiers:
+- **Q1 @quality-misure**: parses pianta-progetto.dxf via ezdxf, checks
+  9 ISO layers (rules.md §3.3), 7 expected room labels, 5 cartiglio
+  CNAPPC fields. Verdict from facts.
+- **Q2 @quality-normativa**: fetches capitolato/CILA/asseverazione/contratto/privacy
+  PDFs, regex 8 canonical refs (DPR 380, UNI 11337, CAM 2025, NTC 2018,
+  D.Lgs 81/2008, D.Lgs 42/2004, L. 49/2023, GDPR Reg. UE 2016/679).
+- **Q3 @quality-dati**: HTTP HEAD on all storage URLs, counts 200/non-200.
+- **Q4 @quality-output**: 14 acceptance criteria + size>0 verification.
+
+Each agent inserts pm_squad_steps (tier=2) with real action_desc
+including verdict + diff. Overall verdict is REJECT if any REJECT,
+CONCERNS if any CONCERNS, else PASS.
+
+### Findings exposed by post-hoc real QA on execution 66db7c46
+The squad shipped as "10/10 AIOS Excellence" had 5 structural bugs
+hidden by the fake QA. Real verdict on 66db7c46:
+
+| Agent | Verdict | Reason |
+|-------|---------|--------|
+| Q1 misure | REJECT | 0/9 ISO layers · 3/7 room labels missing · 0/5 cartiglio fields |
+| Q2 normativa | REJECT | 0/9 canonical refs · capitolato/CILA/asseverazione 3-4 KB stubs |
+| Q3 dati | CONCERNS | 32/32 HEAD OK · but T2 inserts vanished · pm_documents=0 · completed_at=null |
+| Q4 output | PASS-superficial | 14/14 AC by filename match (doesn't verify content) |
+
+### Follow-up issues (not in this PR)
+1. `gen_dxf_pianta_progetto()` emits non-ISO layer names + missing room
+   labels + no cartiglio CNAPPC content
+2. `gen_pdf()` produces 3-4 KB stubs without canonical regulatory citations
+3. 4 T2 inserts vanished from DB despite no thrown exception (root cause
+   unknown · investigation needed)
+4. `pm_documents` not populated (32 storage uploads but zero DB rows ·
+   frontend cannot list deliverables in project tab)
+5. `update_execution(status='completed')` does not set `completed_at`
+
+---
+
+## Execution log
+
+### 2026-04-25 · Attico Brera · execution 66db7c46 · OVERALL REJECT (corrected post-hoc)
+- **Project ID:** 16048505-e340-4aec-b526-05f243c245f5
+- **Cliente:** Marco Rossini & Giulia Bianchi (sample)
+- **Duration:** 17m 52s
+- **Deliverables uploaded:** 32 storage assets (1 moodboard + 5 renders i2i + 26 docs)
+- **Pipeline self-reported:** 4/4 QA PASS (FALSE POSITIVE · pre-fix)
+- **Real QA verdict (manual, by Progetto Chief):** Q1 REJECT · Q2 REJECT · Q3 CONCERNS · Q4 PASS-superficial → OVERALL REJECT
+- **Detailed report:** `/tmp/qa-real/REPORT.md` + `/tmp/qa-real/verdict.json`
+- **Live:** https://lovarch.com/admin/squad-execution/66db7c46-c052-4ebc-854a-78eb8b883640/live
+- **Dossier:** https://lovarch.com/admin/squad-execution/66db7c46-c052-4ebc-854a-78eb8b883640/dossier
+
+#### Run abortado anterior (step_type bug)
+project_id `de953667` + execution_id `42f5a19d` orphan rows in DB
+(lead+phases+budget+finance+portal+1 moodboard upload). Failed at step 02
+because pipeline_runner sent `step_type="execute"` but constraint
+`pm_squad_steps_step_type_check` requires `IN ('orchestration','execution','qa')`.
+Fix (now in main via PR #667): derive from tier (0→orchestration,
+1→execution, 2→qa).
+
+---
+
+## [2.0.0] — 2026-04-25 · 10/10 AIOS Standard Compliance
+
+### Added
+- Squad upgraded to AIOS 6-level structure (all 14 agents)
+- 7 mind clones with [SOURCE:] traceable signature phrases
+- Pattern library AP-* (6 patterns documented)
+- Executor types formal (human/agent/hybrid/worker)
+- Handoff protocol with 9-state status machine
+- Central document `data/architettura-progetto-rules.md` (mandatory consultation)
+- Handoff card template `data/handoff-card-template.md`
+- Handoff quality gate `checklists/handoff-quality-gate.md` (5 sections, 25+ checks)
+- 6 atomic tasks in `tasks/` (audit-input, generate-cad-plan, generate-ifc-model, compute-metric, write-capitolato, consolidate-dossier)
+- Validation script `scripts/validate-squad.py` (executable)
+- 3 smoke test scripts in `scripts/smoke-tests/`
+
+### Changed
+- `config.yaml` upgraded from v1.0 → v2.0 with `pack:` wrapper
+- All 14 agents reformatted: ACTIVATION-NOTICE + YAML embedded + 6-level structure
+- `slashPrefix` corrected to `architetturaProgetto` (camelCase)
+- README.md updated with badge "10/10 AIOS Compliant"
+
+### Mind clones added
+- @quality-misure → W. Edwards Deming (Total Quality Management)
+- @quality-normativa → Joseph Juran (Quality Trilogy)
+- @quality-dati → Larry English (Information Quality)
+- @quality-output → Kent C. Dodds (Testing Trophy)
+- @concept-designer → Patrik Schumacher (ZHA, AI ideation)
+- @bim-engineer → Mark Baldwin (BIM Manager's Handbook)
+- @energy-prelim → Edward Mazria (Architecture 2030)
+
+### Quality score
+- Tier 1 Structure: 10/10
+- Tier 2 Coverage: 10/10
+- Tier 3 Quality: 9.5/10
+- Tier 4 Contextual: 10/10
+- **Final: 9.7/10** (PASS · Excellence)
+
+---
+
+## [1.0.0] — 2026-04-24 · Initial Release (palestra Salone)
+
+### Added
+- 14 agents in 4 tiers (Tier 0/1/2)
+- 4 QA checklists (misure, normativa, dati, output)
+- Workflow `dal-brief-al-cantiere.yaml` (5 phases)
+- 4 templates IT (CILA, contratto, capitolato, asseverazione)
+- Sample input "Attico Brera" (briefing 251 lines + DWG generator)
+- Prezzario Lombardia sample (35 voci)
+- API clients (Mapbox real + Catasto/Firma mocks)
+- Simulator script (20 steps with QA reject + retry)
+- Run script `run_palestra_demo.sh` (5-step orchestrator)
+- Migration SQL 3 tables (pm_squad_executions, pm_squad_steps, pm_squad_qa_checks)
+- 2 React admin pages (live tracking + dossier)
+
+### Quality score
+- Tier 1 Structure: 3/10 (FAIL)
+- Tier 2 Coverage: 7/10
+- Tier 3 Quality: 0.7/10 (FAIL CRITICO)
+- Tier 4 Contextual: 6/10
+- **Final: 1.76/10** (FAIL · functional demo only)
+
+### Known limitations (resolved in 2.0.0)
+- Agents not in AIOS 6-level structure
+- No voice_dna or thinking_dna formal
+- No mind clones
+- Missing central document, CHANGELOG, handoff-quality-gate
+- Missing entry_agent in config
+
+---
+
+## Execution log template
+
+```markdown
+## [Execution N] — YYYY-MM-DD · {project name}
+
+**Cliente:** {nome cliente}
+**Indirizzo:** {indirizzo immobile}
+**Valore opera:** € {valore}
+**Durata totale:** {min}m {sec}s
+**Steps:** {n}
+**QA rejects:** {n}
+**Retries:** {n}
+**Status:** completed | failed | aborted
+
+**Deliverables:** {n} files in {path}
+**Lovarch project_id:** {uuid}
+**Live URL:** /admin/squad-execution/{id}/live
+**Dossier URL:** /admin/squad-execution/{id}/dossier
+
+**Notes:**
+- {any deviation from standard flow}
+- {QA reject specifics if any}
+```