lovarch-cli 0.2.1__tar.gz

lovarch_cli-0.2.1/.gitignore

@@ -0,0 +1,76 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# uv / pip
+.venv/
+venv/
+env/
+ENV/
+.python-version
+uv.lock
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+coverage.xml
+*.cover
+.cache
+
+# Type checking
+.mypy_cache/
+.ruff_cache/
+.dmypy.json
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# CLI runtime data (NEVER commit user credentials)
+.lovarch/
+*.lovarch/
+
+# Squad payload — vendored from monorepo Lovarch (see scripts/refresh_squad_vendor.py).
+# Light vendor (~830KB, no sample-inputs); sample-input villa-chianti is shipped
+# via GitHub Releases and downloaded lazily by `lovarch init --sample`.
+# We ignore the heavy sample-inputs even if accidentally rsynced into the tree.
+lovarch_cli/squad/data/sample-input/
+lovarch_cli/squad/data/sample-input-villa-chianti/
+
+# Local test outputs
+test-output/
+tests/fixtures/output/
+
+# Built bundled docs
+docs/_build/
+site/

lovarch_cli-0.2.1/CHANGELOG.md

@@ -0,0 +1,243 @@
+# Changelog
+
+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).
+
+## [Unreleased]
+
+(No unreleased changes yet — last release was v0.2.1.)
+
+## [0.2.1] — 2026-07-03
+
+### Fixed
+
+- Python 3.11: f-string with a backslash escape in the expression part
+  (verifica contratto) crashed the whole CLI at import time on 3.11
+  (3.12+ tolerates it). Moved the escape out of the expression.
+- Lint: unused import in tests.
+
+## [0.2.0] — 2026-07-03
+
+### Added — Premium billing, MCP server, platform workflows, verifica
+
+The release that makes the premium CLI bill and behave like the platform:
+
+- **Credit debit for real**: premium `lovarch run` now routes ALL paid AI
+  through the `cli-ai-generate` / `cli-ai-text` Edge Functions, debiting the
+  user's Lovarch credits (1000cr=$1) with refund on failure. The runner no
+  longer needs the student's `OPENAI_API_KEY` nor a service_role key —
+  persistence writes as the USER (RLS).
+- **MCP server** — `lovarch mcp serve` (stdio; `pip install 'lovarch-cli[mcp]'`
+  or bundled). 15 tools: whoami, credits, generate_image, ai_text (multi-model:
+  executor=Sonnet 5 · verifier/chief=Opus 4.8, or explicit model from the
+  platform catalog), context, render, colors, copy, audit_input, list_projects,
+  verify_misure/normativa/contratto/dossier, job_status.
+  Register: `claude mcp add lovarch -- lovarch mcp serve`.
+- **`lovarch do render|colors|copy`** — platform workflows from the terminal
+  (Render Studio 2D/3D with reference image, brand palettes, marketing copy).
+- **`lovarch verifica misure|normativa|contratto|dossier`** — data checking for
+  professionals: deterministic DXF checks (free) + ADVERSARIAL two-model
+  document checks (Sonnet extracts → Opus refutes phantom articles; CNAPPC
+  contract structure + compenso rule QN_007).
+- **`lovarch context show`** — the personalization bundle agents use (brand,
+  style, professional signature, fiscal data, output language).
+- **`lovarch jobs list|status`** — async platform jobs (video/export/upscale).
+- **`lovarch config`** — user preferences + BYO API keys for free mode.
+
+### Changed
+
+- User-facing cost is ALWAYS credits — provider USD amounts never appear in any
+  CLI/MCP output.
+- Output language strictly follows the user's configured language.
+
+### Dependencies
+
+- New: `pypdf` (PDF text extraction) · optional extra `[mcp]`.
+
+
+## [0.1.2] — 2026-06-12
+
+### Fixed
+
+- `lovarch run` now maps the pipeline's `qa_rejected` exit code (3) to a
+  distinct `last_run.status`, instead of collapsing it into a generic
+  failure. A QA-rejected dossier is no longer reported as completed.
+- Vendored squad snapshot refreshed with the 2026-06-12 audit corrections
+  (pipeline no longer marks a run COMPLETED when a Tier 2 QA agent returns
+  REJECT).
+
+### Docs
+
+- README version examples and test count aligned with the shipped release.
+
+## [0.1.1] — 2026-05-11
+
+### Added — Squad development loop
+
+Unlocks the daily iteration cycle on squad-architettura-progetto agents
+without refresh round-trips. Maintainer edits the monorepo, every
+`lovarch run` invocation picks up the change immediately.
+
+- `LOVARCH_SQUAD_SRC` environment variable and `--squad-src` flag on
+  `lovarch run` and `lovarch init`. Resolution chain: flag > env var >
+  bundled vendor. When an override is active, `lovarch run` prints
+  `↳ squad: <path> (source)` so the user knows which payload is in use.
+- New module `lovarch_cli/squad_loader.py` centralizes the resolution
+  logic. Validates that the resolved path looks like a squad payload
+  (has `scripts/pipeline_runner.py` + `agents/`) and raises
+  `SquadNotFoundError` with an actionable message otherwise.
+- `lovarch dev show-squad-root` prints which squad path is currently
+  resolved, plus env var value and bundled fallback for debugging.
+- `lovarch dev refresh-squad [--source PATH] [--target PATH] [--dry-run]`
+  promotes monorepo edits into the vendored snapshot in this repo.
+  Auto-detects target via `__file__` heuristic when running from a dev
+  install (`pip install -e`).
+- `docs/agent-development.md` documents the three-environment model
+  (DEV / STAGED / PRODUCTION), the daily iteration loop, the promotion
+  flow, release cadence, and common pitfalls.
+
+### Other
+
+- Initial v0.1.0 stable release infrastructure validated end-to-end
+  (homebrew tap auto-bump after the secret-context fix in PR #7,
+  GitHub Release attach workflow, brew install + smoke test working
+  on Pablo's machine).
+
+### Distribution strategy
+
+`lovarch-cli` ships via three channels — **PyPI is NOT one of them** for v0.1:
+
+1. **Homebrew tap** (`brew install lovarch-cli`) — primary install for
+   macOS/Linux users
+2. **pipx from GitHub** (`pipx install git+https://...`) — for Python-savvy
+   users who prefer isolated venv
+3. **Source clone + pip install -e** — for contributors
+
+PyPI publication (`pip install lovarch-cli`) is deferred to v0.2+ to avoid
+the token/2FA setup overhead. The `publish-pypi.yml` workflow is kept as
+manual `workflow_dispatch` so it can be activated when wanted, without
+running automatically on every tag.
+
+### Deferred to Q3
+
+- **Story 1.3 — `pipeline_runner.py` refactor**: split the 1821-line legacy
+  runner into modular phases. Currently shelled out via subprocess; works
+  but is hard to unit-test independently. Adding `--legacy-runner` flag
+  to allow fallback during the migration.
+- **PyPI publication**: re-enable `publish-pypi.yml` on `push: tags: [v*]`
+  trigger once a PyPI account + project-scoped token are configured.
+
+## [0.1.0-beta.1] — 2026-05-10
+
+First public BETA. Repository extracted from the Lovarch monorepo into
+`ArchPrime-official/lovarch-cli` via `git filter-repo`. 13 commits of
+CLI-specific history preserved.
+
+### Added — Commands (Fase A)
+
+- `lovarch info` — version + squad + mode status panel
+- `lovarch init <name>` — scaffold a project with `input/`, `output/`,
+  `project.yaml`. `--sample` lazily downloads the villa-chianti starter
+  from GitHub Releases (SHA256 verified, cached in `~/.lovarch/cache/`).
+  `--workflow`, `--force`, `--home` overrides.
+- `lovarch audit <name>` — 18-point input checklist in 3 tiers:
+  REQUIRED (10 — failure means FAIL verdict), RECOMMENDED (4 — CONCERNS),
+  BRIEFING DEPTH (4 — CONCERNS). `--json` flag for CI integration.
+  Persists `last_audit` in `project.yaml`.
+- `lovarch run <workflow> <project>` — pre-flight gates (project exists,
+  input non-empty, last audit ≠ FAIL, credits for Premium).
+  Free mode: subprocess `pipeline_runner.py --dry-run` (simulation, no API
+  calls). Premium mode: subprocess `--real` (debits Lovarch credits).
+  `--skip-audit`, `--skip-credits`, `--dry-run` escape hatches.
+- `lovarch consolidate <name>` — filename-prefix → 6-folder routing
+  (`00-validation/`, `01-bootstrap/`, `02-concept/`, `03-tier1/`,
+  `04-tier2/`, `05-dossier/`) + `99-other/` fallback. ZIP includes a
+  localized README in 4 languages. Persists `last_dossier` in
+  `project.yaml`.
+- `lovarch status [<name>]` — list view (all projects with workflow + audit
+  verdict + dossier state + age) or detail view (audit breakdown, dossier
+  path/size, output count). Reads only `project.yaml`, no backend.
+
+### Added — Auth & Account
+
+- `lovarch signup` — interactive Free signup with GDPR consent. Calls
+  `cli-signup` Edge Function in the Lovarch monorepo; persists token
+  via OS keyring.
+- `lovarch login` — interactive mode selection (free/premium). Premium
+  uses PKCE OAuth flow with local callback server; falls back to manual
+  URL if browser cannot open.
+- `lovarch account info` / `lovarch account delete` — GDPR right-to-erasure
+  (pseudonymizes remote data, revokes token; optionally wipes
+  `~/.lovarch/projects/`).
+- `lovarch upgrade` — opens `/cli-upgrade` (Free) or `/settings/credits`
+  (Premium) with `creds.language` preference.
+
+### Added — Infrastructure
+
+- 4 languages bundled (it/pt/en/es) with parity anti-drift tests
+  (`tests/test_i18n_loader.py`). 120+ keys across `signup`/`account`/
+  `login`/`info`/`errors`/`upgrade`/`init`/`audit`/`run`/`consolidate`/
+  `status` namespaces. Italian is the default; detection via `--lang`
+  flag → `LOVARCH_LANG` env → `LANG` env → `'it'`.
+- `DataPersistenceClient` ABC with `LocalSqliteClient` (Free) and
+  `LovarchSupabaseClient` (Premium) implementations. Mirrors the
+  `pm_squad_executions` / `pm_squad_steps` / `pm_squad_qa_checks`
+  monorepo tables.
+- `CreditsClient` ABC with `FreeCreditsClient` (no-op) and
+  `LovarchCreditsClient` (calls `cli-credits-check` Edge Function with
+  auto-refresh-on-401).
+- 142 pytest passing in 0.7s (smoke E2E + unit coverage for i18n,
+  credits, persistence, audit, init, consolidate, status,
+  sample_downloader).
+- CI matrix Python 3.11/3.12/3.13 + pyflakes + smoke (lovarch info /
+  arch alias).
+- Bundled squad (architettura-progetto, ~830KB) — 17 agents, 6 tasks,
+  1 workflow (`dal-brief-al-cantiere`), 5 checklists, 4 templates. Heavy
+  sample-input villa-chianti (49MB) shipped as a GitHub Releases asset
+  and downloaded lazily by `lovarch init --sample`.
+- Build hook (`scripts/sync_squad.py`) two-mode behavior: NO-OP in
+  standalone repo (preserves vendor); re-syncs from sibling
+  `squads/architettura-progetto/` in monorepo dev.
+- Manual vendor refresh: `scripts/refresh_squad_vendor.py`.
+- Release infrastructure:
+  - `.github/workflows/publish-pypi.yml` — verifies tag matches
+    `lovarch_cli/version.py`, builds wheel + sdist, uploads to PyPI for
+    final tags only (skip pre-release).
+  - `.github/workflows/attach-to-release.yml` — attaches wheel + sdist
+    to the GitHub Release for every `v*` tag.
+  - `.github/workflows/bump-homebrew-formula.yml` — auto-opens bump PR
+    in `ArchPrime-official/homebrew-lovarch` when a final tag is pushed.
+
+### Documentation
+
+- `docs/squad-vendoring.md` — what is vendored, what isn't, why, how to
+  refresh.
+- `docs/release-process.md` — semver bump policy, tag conventions
+  (final vs pre-release), PyPI/Homebrew setup steps, rollback guide.
+- `MIGRATION-PLAN.md` — executed runbook documenting the monorepo →
+  standalone split (filter-repo, history preservation, etc.).
+
+### Companion repositories
+
+- [`ArchPrime-official/homebrew-lovarch`](https://github.com/ArchPrime-official/homebrew-lovarch)
+  — Homebrew tap with `Formula/lovarch-cli.rb`. CI tested via
+  `brew install --build-from-source` + `brew test` on macos-latest.
+
+### Known limitations
+
+- `pip install lovarch-cli` (from PyPI) is intentionally not supported
+  in v0.1 — install via `brew tap` + `brew install` OR `pipx install git+...`
+  (see README). PyPI deferred to v0.2+.
+- `brew install lovarch-cli` requires the `brew tap archprime-official/lovarch`
+  step first (no homebrew-core submission yet).
+- `arch run` shells out to the legacy 1821-line `pipeline_runner.py` —
+  Story 1.3 refactor deferred to Q3.
+- Voice/avatar/render features depend on Edge Functions in the Lovarch
+  monorepo — Free dry-run does NOT actually call them.
+
+[Unreleased]: https://github.com/ArchPrime-official/lovarch-cli/compare/v0.1.1...HEAD
+[0.1.1]: https://github.com/ArchPrime-official/lovarch-cli/compare/v0.1.0...v0.1.1
+[0.1.0]: https://github.com/ArchPrime-official/lovarch-cli/compare/v0.1.0-beta.1...v0.1.0
+[0.1.0-beta.1]: https://github.com/ArchPrime-official/lovarch-cli/releases/tag/v0.1.0-beta.1

lovarch_cli-0.2.1/LICENSE

@@ -0,0 +1,38 @@
+MIT License
+
+Copyright (c) 2026 Pablo Ruan Lopes / Lovarch
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+ADDITIONAL NOTICE FOR ITALIAN LEGAL/REGULATORY OUTPUT:
+
+This software generates pre-compiled drafts of Italian regulatory documents
+(CILA, SCIA, Paesaggistica, Capitolato d'Appalto) based on DPR 380/2001,
+UNI 11337-7, CAM Edilizia 2025, and CNAPPC 2023 frameworks.
+
+These outputs DO NOT replace:
+- Qualified electronic signature (firma digitale QES) of a licensed architect
+- Professional liability of an authorized architect (architetto abilitato)
+- On-site survey and structural verification per NTC 2018
+- Health & safety coordination per D.Lgs 81/2008
+
+The user assumes full responsibility for verifying outputs and obtaining
+the necessary professional review before submission to any authority.

lovarch_cli-0.2.1/PKG-INFO

@@ -0,0 +1,232 @@
+Metadata-Version: 2.4
+Name: lovarch-cli
+Version: 0.2.1
+Summary: AI-powered architectural project execution CLI by Lovarch
+Project-URL: Homepage, https://archprime.io
+Project-URL: Documentation, https://lovarch.com/cli-docs
+Project-URL: Repository, https://github.com/ArchPrime-official/lovarch-cli
+Project-URL: Issues, https://github.com/ArchPrime-official/lovarch-cli/issues
+Project-URL: Changelog, https://github.com/ArchPrime-official/lovarch-cli/releases
+Project-URL: Course, https://lovarch.com/corso
+Author-email: Pablo Ruan Lopes <pablo@archprime.io>
+License: MIT
+License-File: LICENSE
+Keywords: ai,architecture,bim,cad,cila,ifc,italy,lovarch,uni-11337
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Natural Language :: Italian
+Classifier: Natural Language :: Portuguese
+Classifier: Natural Language :: Spanish
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.11
+Requires-Dist: ezdxf<2.0,>=1.3
+Requires-Dist: httpx<0.29,>=0.27
+Requires-Dist: ifcopenshell<0.9,>=0.7
+Requires-Dist: keyring<26.0,>=24.0
+Requires-Dist: pillow<12.0,>=10.0
+Requires-Dist: pydantic<3.0,>=2.6
+Requires-Dist: pypdf<6.0,>=4.0
+Requires-Dist: pyyaml<7.0,>=6.0
+Requires-Dist: reportlab<5.0,>=4.0
+Requires-Dist: rich<14.0,>=13.7
+Requires-Dist: typer<0.16,>=0.12
+Requires-Dist: xlsxwriter<4.0,>=3.2
+Provides-Extra: dev
+Requires-Dist: mcp>=1.2; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pre-commit>=3.6; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.2; extra == 'mcp'
+Provides-Extra: premium
+Requires-Dist: supabase<3.0,>=2.4; extra == 'premium'
+Description-Content-Type: text/markdown
+
+# lovarch-cli
+
+[![CI](https://github.com/ArchPrime-official/lovarch-cli/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/ArchPrime-official/lovarch-cli/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
+[![Release](https://img.shields.io/github/v/release/ArchPrime-official/lovarch-cli?include_prereleases)](https://github.com/ArchPrime-official/lovarch-cli/releases)
+
+> **AI-powered architectural project execution CLI** — squad di 17 agenti specializzati che esegue audit input, briefing, normativa IT, CAD, BIM/IFC, computo metrico, capitolato, pratiche edilizie (CILA/SCIA), contratto CNAPPC, energy/LCA preliminare, dossier consolidato — in 14 minuti vs 3 settimane di lavoro tradizionale.
+
+> ⚠️ **Status: BETA (v0.1.x)** — distribuito via Homebrew tap + pipx-from-git. Usato in produzione dagli iscritti al [Corso IA Avanzato per Architetti](https://lovarch.com/corso) (€1.497). Pubblicazione su PyPI valutata per v0.2+.
+
+🌐 **Lingue:** [🇮🇹 Italiano](README.md) (default) · [🇵🇹 Português](README.pt.md) · [🇬🇧 English](README.en.md) · [🇪🇸 Español](README.es.md)
+
+---
+
+## Cosa fa
+
+`lovarch-cli` orchestra il **Squad Architettura-Progetto** di Lovarch — 17 agenti AI con framework documentati (mind clones di Schumacher, Baldwin, Mazria, Deming, Juran, English, Dodds) — per generare 27 deliverable architettonici conformi alla normativa italiana:
+
+- **Audit input** (18 controlli) prima di iniziare
+- **CAD quotato** DXF/PDF (UNI ISO 5457, ±1mm)
+- **BIM IFC4 LOD 300**
+- **Computo metrico** (Prezzario Lombardia 2025)
+- **Capitolato Speciale d'Appalto** (UNI 11337-7 + CAM 2025)
+- **Pratiche edilizie pre-compilate** (CILA/SCIA/Paesaggistica)
+- **Contratto CNAPPC** + Equo Compenso L.49/2023
+- **APE Preliminare + LCA Embodied Carbon**
+- **Dossier finale** ZIP con 27 documenti
+
+## Due modalità
+
+### 🆓 Free Mode (registrazione richiesta)
+
+```bash
+lovarch signup
+# → Cadastro: Nome completo, email, telefono, paese, lingua
+```
+
+- Esegui il squad **localmente** con i tuoi propri API keys (OpenAI, Mapbox, fal.ai)
+- Storage in `~/.lovarch/projects/` (filesystem locale)
+- Database in `~/.lovarch/local.db` (SQLite)
+- Tutti i 17 agenti disponibili
+- Tu paghi le tue API direttamente ai provider
+
+### ⭐ Premium Mode (login Lovarch)
+
+```bash
+arch login --premium
+# → Apre il browser per autenticazione Lovarch (PKCE flow)
+```
+
+- Login con il tuo account Lovarch esistente
+- Crediti inclusi nel piano (Personal €49 / Studio €99 / Business €199)
+- Backend Lovarch (Supabase + S3 + Edge Functions ottimizzate)
+- Sincronizzazione web app `lovarch.com/admin/squad-execution/{id}/live`
+- Team member ownership automatico
+
+## Installazione
+
+### 🍺 Homebrew (raccomandato — macOS / Linux)
+
+Il modo più semplice. Funziona anche per chi non ha familiarità con Python:
+
+```bash
+brew tap archprime-official/lovarch
+brew install lovarch-cli
+lovarch --version
+```
+
+`brew upgrade lovarch-cli` aggiorna alla nuova release.
+
+### 📦 pipx — install isolato da GitHub
+
+Se preferisci un'install Python isolata senza Homebrew (utile su Linux server,
+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
+
+# Oppure dal branch main (rolling):
+pipx install git+https://github.com/ArchPrime-official/lovarch-cli.git
+```
+
+`pipx upgrade lovarch-cli` aggiorna alla revisione successiva.
+
+### 🛠️ Da sorgente (per sviluppatori / contributori)
+
+```bash
+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
+lovarch --version
+```
+
+Vedi [CONTRIBUTING.md](./CONTRIBUTING.md) per il workflow di sviluppo.
+
+> Backward compatibility: il comando `arch` è alias di `lovarch` per chi ha già muscle memory dalla versione interna di sviluppo.
+>
+> PyPI: la pubblicazione su `pip install lovarch-cli` è rimandata a v0.2+ (i metodi qui sopra coprono tutti i casi d'uso senza dipendere dalla burocrazia PyPI token/2FA).
+
+## Quick start
+
+```bash
+# Verifica installazione
+lovarch --version    # → lovarch-cli 0.1.2
+
+# Primo login (interattivo: Free o Premium)
+lovarch login
+
+# Inizializza un progetto (con --sample scarica villa-chianti da GitHub Releases)
+lovarch init villa-toscana --sample
+
+# Audit dei 18 input prima di girare il pipeline
+lovarch audit villa-toscana
+
+# Esegui workflow (Free=dry-run · Premium=produzione)
+lovarch run dal-brief-al-cantiere villa-toscana
+
+# Consolida deliverable in DOSSIER.zip
+lovarch consolidate villa-toscana
+
+# Stato di tutti i progetti
+lovarch status
+```
+
+## Comandi disponibili
+
+| Comando | Descrizione |
+|---------|-------------|
+| `arch login` | Login Free o Premium |
+| `arch signup` | Cadastro Free interattivo |
+| `arch config` | Configurazione (API keys, lingua, storage path) — _in arrivo (v0.2)_ |
+| `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 |
+| `arch consolidate <progetto>` | Genera DOSSIER.zip finale |
+| `arch status <id>` | Stato di una esecuzione |
+| `arch upgrade` | CTA per passare da Free a Premium |
+| `arch account delete` | Right-to-erasure GDPR |
+
+Vedi `arch --help` per dettagli completi.
+
+## Limiti dichiarati
+
+`lovarch-cli` **NON** sostituisce:
+
+- ❌ Firma digitale qualificata (QES) dell'architetto abilitato
+- ❌ Calcolo strutturale NTC 2018 (richiede ingegnere strutturale)
+- ❌ Rilievo metrico in loco (richiede sopralluogo)
+- ❌ Coordinamento sicurezza CSP/CSE (D.Lgs 81/2008)
+- ❌ Responsabilità professionale del tecnico
+
+L'utente assume la responsabilità di verifica e revisione professionale prima di qualsiasi presentazione ad autorità.
+
+## Licenza
+
+MIT License — vedi [LICENSE](LICENSE).
+
+## Link
+
+- 🌐 [archprime.io](https://archprime.io) · [lovarch.com](https://lovarch.com)
+- 📚 [Documentazione](https://docs.archprime.io/cli)
+- 🐛 [Issues](https://github.com/ArchPrime-official/lovarch-cli/issues)
+- 📋 [Releases](https://github.com/ArchPrime-official/lovarch-cli/releases) · [Changelog](./CHANGELOG.md)
+- 🤝 [Contributing](./CONTRIBUTING.md)
+- 🎓 [Corso IA Avanzato per Architetti](https://lovarch.com/corso) (€1.497)
+
+---
+
+🤖 Powered by [Lovarch](https://lovarch.com) — AI Growth System for Architects & Designers