clified 0.4.0__tar.gz

clified-0.4.0/.gitignore

@@ -0,0 +1,34 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+dist/
+build/
+*.egg
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# Ambientes locais
+.installer-venv/
+.venv/
+venv/
+.env
+
+# Config local do workspace (copie de tools.yaml.example)
+tools.yaml
+
+# Estado local
+.clified/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db

clified-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Maikeu Locatelli
+
+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.

clified-0.4.0/PKG-INFO

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: clified
+Version: 0.4.0
+Summary: Instalador universal e biblioteca CLI para ferramentas Python, Rust e Bun
+Project-URL: Homepage, https://github.com/maikramer/clified
+Project-URL: Repository, https://github.com/maikramer/clified
+Project-URL: Issues, https://github.com/maikramer/clified/issues
+Author: Maikeu Locatelli
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cli,devtools,installer,python,rust
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.10
+Requires-Dist: pydantic>=2
+Requires-Dist: pyyaml>=6
+Requires-Dist: rich>=13
+Provides-Extra: cli
+Requires-Dist: click>=8; extra == 'cli'
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.9; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Clified
+
+Instalador universal e **biblioteca CLI** para ferramentas Python, Rust e Bun.
+
+Infraestrutura reutilizável consolidada a partir de **denv** (LocatelliDockerManager), **pc** (ProjetoCursor) e **GameDev** — sem hardcodar ferramentas no código.
+
+## Estrutura
+
+```
+clified/
+├── install.sh / install.ps1 / install.bat
+├── tools.yaml                               # registry local (gitignored)
+├── tools.yaml.example
+├── examples/                                # migração GameDev / denv / pc
+├── config/
+│   ├── clified.yml.example
+│   ├── install-all-constraints.txt
+│   └── gamedev-constraints.txt.example
+└── src/clified/
+    ├── logging.py
+    ├── cli/                                 # output JSON, Click scaffold, StepRunner
+    ├── core/                                # config, retry, paths, state
+    ├── patterns/                            # diagnóstico regex + reporter
+    ├── hooks/                               # MCP, skills, pip check, nvdiffrast
+    ├── integrations/mcp.py
+    └── installer/
+```
+
+## Instalação
+
+### PyPI (recomendado)
+
+```bash
+pip install --user clified
+# ou: pipx install clified
+
+clified-install --list
+clified-install minha-ferramenta
+```
+
+Cada repositório de ferramenta traz o seu `tools.yaml` e define `CLIFIED_TOOLS` no `install.sh` — **não é necessário clonar o Clified**.
+
+### Desenvolvimento do Clified
+
+```bash
+git clone https://github.com/maikramer/clified.git
+cd clified
+pip install -e ".[dev]"
+cp tools.yaml.example tools.yaml   # registry local opcional
+./install.sh --list
+```
+
+Para CLIs Click: `pip install -e ".[cli]"` (grupo `--json` / `--quiet` / `--verbose`).
+
+### Publicar no PyPI
+
+```bash
+pip install hatch
+hatch build
+hatch publish   # requer credenciais PyPI / token
+```
+
+Ou crie um **GitHub Release** — o workflow `.github/workflows/publish.yml` publica automaticamente (Trusted Publishing).
+
+## Migração de workspaces existentes
+
+| Origem | Exemplo YAML | O que fica no repo original |
+|--------|--------------|----------------------------|
+| **GameDev** | `examples/tools.gamedev.yaml.example` | `*_extras.py`, constraints ML, lógica PyTorch |
+| **denv** | `examples/tools.denv.yaml.example` | Docker/Swarm, FastMCP server |
+| **pc** | `examples/tools.pc.yaml.example` | comandos Flutter/deploy, skill do projecto |
+
+Campos novos em `tools.yaml`:
+
+| Campo | Uso |
+|-------|-----|
+| `custom_install` | Hook `modulo:func(installer)` substituindo `pip install -e` |
+| `install_before_mode: venv_only` | Equivalente ao `--text2d-venv-only` do GameDev |
+| `install_order` | Ordem em `clified-install all` |
+| `post_install` | MCP, skills Cursor, `pip check`, etc. |
+
+Hooks prontos (`clified.hooks`):
+
+- `register_mcp` / `register_mcp_serve` — Cursor MCP
+- `register_cursor_skill` — skill do pc/GameDev
+- `pip_check` — validação pós-install
+- `install_nvdiffrast` — extra PyTorch (GameDev)
+
+## Desenvolvimento
+
+```bash
+pip install -e ".[dev]"
+pytest -q
+```
+
+## Biblioteca para os seus CLIs
+
+```python
+from clified.cli import OutputFormatter, handle_cli_errors
+from clified.cli.app import create_cli_group  # pip install clified[cli]
+from clified.cli.progress import StepRunner, Step
+from clified.core import find_project_root, RetryEngine, get_state_store
+from clified.patterns import diagnose_text
+
+out = OutputFormatter(json_mode=True)
+out.success({"tool": "mytool"})
+
+report = diagnose_text(log_text)
+print(report.to_markdown())
+```
+
+## Hooks e MCP
+
+```yaml
+tools:
+  denv:
+    kind: python
+    folder: ../LocatelliDockerManager
+    cli_name: denv
+    post_install: clified.hooks:register_mcp_serve
+```
+
+## Variáveis de ambiente
+
+| Variável | Descrição |
+|----------|-----------|
+| `CLIFIED_TOOLS` | Caminho para `tools.yaml` do projecto (**principal**) |
+| `CLIFIED_HOME` | Config do utilizador (default `~/.config/clified`) |
+| `CLIFIED_ROOT` | Checkout local do Clified (só dev) |
+| `CLIFIED_MIN_VERSION` | Versão mínima no `pip install` automático (default `0.4.0`) |
+| `CLIFIED_RETRY=1` | Retry automático na instalação |
+| `CLIFIED_MCP_NAME` | Nome do servidor MCP (hook) |
+| `CLIFIED_PROJECT_ROOT` | Override para `find_project_root()` |
+| `INSTALL_PREFIX` | Prefixo (~/.local) |
+
+## Origem do código
+
+| Clified | Origem |
+|---------|--------|
+| `cli/output.py`, `cli/decorators.py` | denv |
+| `cli/app.py`, `cli/progress.py` | denv + pc (`DeployUI` / StepRunner) |
+| `core/paths.py` | pc |
+| `hooks/skills.py` | GameDev `skill_install.py` |
+| `hooks/mcp.py`, `hooks/pytorch.py` | denv + GameDev |
+| `patterns/reporter.py` | denv `DiagnosisReporter` |
+| `installer/registry.py` (campos extras) | GameDev unified installer |
+
+A lógica Docker/Swarm permanece no denv; pipelines ML específicos permanecem no GameDev — registados via YAML, não hardcoded.

clified-0.4.0/README.md

@@ -0,0 +1,148 @@
+# Clified
+
+Instalador universal e **biblioteca CLI** para ferramentas Python, Rust e Bun.
+
+Infraestrutura reutilizável consolidada a partir de **denv** (LocatelliDockerManager), **pc** (ProjetoCursor) e **GameDev** — sem hardcodar ferramentas no código.
+
+## Estrutura
+
+```
+clified/
+├── install.sh / install.ps1 / install.bat
+├── tools.yaml                               # registry local (gitignored)
+├── tools.yaml.example
+├── examples/                                # migração GameDev / denv / pc
+├── config/
+│   ├── clified.yml.example
+│   ├── install-all-constraints.txt
+│   └── gamedev-constraints.txt.example
+└── src/clified/
+    ├── logging.py
+    ├── cli/                                 # output JSON, Click scaffold, StepRunner
+    ├── core/                                # config, retry, paths, state
+    ├── patterns/                            # diagnóstico regex + reporter
+    ├── hooks/                               # MCP, skills, pip check, nvdiffrast
+    ├── integrations/mcp.py
+    └── installer/
+```
+
+## Instalação
+
+### PyPI (recomendado)
+
+```bash
+pip install --user clified
+# ou: pipx install clified
+
+clified-install --list
+clified-install minha-ferramenta
+```
+
+Cada repositório de ferramenta traz o seu `tools.yaml` e define `CLIFIED_TOOLS` no `install.sh` — **não é necessário clonar o Clified**.
+
+### Desenvolvimento do Clified
+
+```bash
+git clone https://github.com/maikramer/clified.git
+cd clified
+pip install -e ".[dev]"
+cp tools.yaml.example tools.yaml   # registry local opcional
+./install.sh --list
+```
+
+Para CLIs Click: `pip install -e ".[cli]"` (grupo `--json` / `--quiet` / `--verbose`).
+
+### Publicar no PyPI
+
+```bash
+pip install hatch
+hatch build
+hatch publish   # requer credenciais PyPI / token
+```
+
+Ou crie um **GitHub Release** — o workflow `.github/workflows/publish.yml` publica automaticamente (Trusted Publishing).
+
+## Migração de workspaces existentes
+
+| Origem | Exemplo YAML | O que fica no repo original |
+|--------|--------------|----------------------------|
+| **GameDev** | `examples/tools.gamedev.yaml.example` | `*_extras.py`, constraints ML, lógica PyTorch |
+| **denv** | `examples/tools.denv.yaml.example` | Docker/Swarm, FastMCP server |
+| **pc** | `examples/tools.pc.yaml.example` | comandos Flutter/deploy, skill do projecto |
+
+Campos novos em `tools.yaml`:
+
+| Campo | Uso |
+|-------|-----|
+| `custom_install` | Hook `modulo:func(installer)` substituindo `pip install -e` |
+| `install_before_mode: venv_only` | Equivalente ao `--text2d-venv-only` do GameDev |
+| `install_order` | Ordem em `clified-install all` |
+| `post_install` | MCP, skills Cursor, `pip check`, etc. |
+
+Hooks prontos (`clified.hooks`):
+
+- `register_mcp` / `register_mcp_serve` — Cursor MCP
+- `register_cursor_skill` — skill do pc/GameDev
+- `pip_check` — validação pós-install
+- `install_nvdiffrast` — extra PyTorch (GameDev)
+
+## Desenvolvimento
+
+```bash
+pip install -e ".[dev]"
+pytest -q
+```
+
+## Biblioteca para os seus CLIs
+
+```python
+from clified.cli import OutputFormatter, handle_cli_errors
+from clified.cli.app import create_cli_group  # pip install clified[cli]
+from clified.cli.progress import StepRunner, Step
+from clified.core import find_project_root, RetryEngine, get_state_store
+from clified.patterns import diagnose_text
+
+out = OutputFormatter(json_mode=True)
+out.success({"tool": "mytool"})
+
+report = diagnose_text(log_text)
+print(report.to_markdown())
+```
+
+## Hooks e MCP
+
+```yaml
+tools:
+  denv:
+    kind: python
+    folder: ../LocatelliDockerManager
+    cli_name: denv
+    post_install: clified.hooks:register_mcp_serve
+```
+
+## Variáveis de ambiente
+
+| Variável | Descrição |
+|----------|-----------|
+| `CLIFIED_TOOLS` | Caminho para `tools.yaml` do projecto (**principal**) |
+| `CLIFIED_HOME` | Config do utilizador (default `~/.config/clified`) |
+| `CLIFIED_ROOT` | Checkout local do Clified (só dev) |
+| `CLIFIED_MIN_VERSION` | Versão mínima no `pip install` automático (default `0.4.0`) |
+| `CLIFIED_RETRY=1` | Retry automático na instalação |
+| `CLIFIED_MCP_NAME` | Nome do servidor MCP (hook) |
+| `CLIFIED_PROJECT_ROOT` | Override para `find_project_root()` |
+| `INSTALL_PREFIX` | Prefixo (~/.local) |
+
+## Origem do código
+
+| Clified | Origem |
+|---------|--------|
+| `cli/output.py`, `cli/decorators.py` | denv |
+| `cli/app.py`, `cli/progress.py` | denv + pc (`DeployUI` / StepRunner) |
+| `core/paths.py` | pc |
+| `hooks/skills.py` | GameDev `skill_install.py` |
+| `hooks/mcp.py`, `hooks/pytorch.py` | denv + GameDev |
+| `patterns/reporter.py` | denv `DiagnosisReporter` |
+| `installer/registry.py` (campos extras) | GameDev unified installer |
+
+A lógica Docker/Swarm permanece no denv; pipelines ML específicos permanecem no GameDev — registados via YAML, não hardcoded.

clified-0.4.0/config/clified.yml.example

@@ -0,0 +1,17 @@
+# Configuração global opcional do Clified.
+# Copie para config/clified.yml para personalizar.
+
+base_dir: ~/.clified
+
+logging:
+  level: INFO
+
+retry:
+  max_attempts: 3
+  base_delay: 2.0
+  max_delay: 60.0
+
+install:
+  prefix: ~/.local
+  use_uv: true
+  default_python: python3

clified-0.4.0/config/gamedev-constraints.txt.example

@@ -0,0 +1,5 @@
+# Constraints para ``clified-install all`` em workspaces ML (GameDev)
+# Copie para config/install-all-constraints.txt quando usar várias tools PyTorch
+
+transformers==4.51.3
+numpy>=2.4.5,<3

clified-0.4.0/config/install-all-constraints.txt

@@ -0,0 +1,2 @@
+# Constraints opcionais para ``clified-install all`` (pip -c).
+# Deixe vazio ou comente linhas que não usar.

clified-0.4.0/examples/tools.denv.yaml.example

@@ -0,0 +1,17 @@
+# Exemplo: registrar denv (LocatelliDockerManager) via Clified
+
+workspace:
+  root: "/home/maikeu/GitClones"
+  name: "GitClones"
+
+tools:
+  denv:
+    name: "DENV"
+    kind: python
+    folder: LocatelliDockerManager
+    cli_name: denv
+    python_module: denv
+    description: "Docker Environment Manager — Swarm, stacks, diagnóstico"
+    min_python: [3, 12]
+    post_install: clified.hooks:register_mcp_serve
+    # Instalação: poetry/pip install -e no projecto; Clified gere venv + wrapper

clified-0.4.0/examples/tools.gamedev.yaml.example

@@ -0,0 +1,63 @@
+# Exemplo: migrar monorepo GameDev para Clified
+# Copie secções relevantes para o seu tools.yaml
+# Hooks específicos ficam no repo GameDev (gamedev_shared.installer.clified_hooks)
+
+workspace:
+  root: "/caminho/para/GameDev"
+  name: "GameDev"
+  shared_python:
+    path: Shared
+    import_name: gamedev_shared
+    src_subpath: src
+
+tools:
+  text2d:
+    kind: python
+    folder: Text2D
+    cli_name: text2d
+    python_module: text2d
+    description: "CLI text-to-image"
+    min_python: [3, 13]
+    needs_pytorch: true
+    install_order: -2
+    post_install: clified.hooks:pip_check
+
+  text3d:
+    kind: python
+    folder: Text3D
+    cli_name: text3d
+    python_module: text3d
+    description: "Pipeline text-to-3D"
+    min_python: [3, 13]
+    needs_pytorch: true
+    install_order: -1
+    install_before: [text2d]
+    cross_deps: [text2d]
+    post_install: gamedev_shared.installer.clified_hooks:text3d_post_install
+
+  materialize:
+    kind: rust
+    folder: Materialize
+    cli_name: materialize
+    cargo_bin_name: materialize-cli
+    description: "PBR maps via GPU"
+
+  text2sound:
+    kind: python
+    folder: Text2Sound
+    cli_name: text2sound
+    python_module: text2sound
+    description: "CLI text-to-audio"
+    min_python: [3, 13]
+    needs_pytorch: true
+    custom_install: gamedev_shared.installer.clified_hooks:text2sound_custom_install
+
+  paint3d:
+    kind: python
+    folder: Paint3D
+    cli_name: paint3d
+    python_module: paint3d
+    description: "Texturização 3D PBR"
+    min_python: [3, 13]
+    needs_pytorch: true
+    post_install: gamedev_shared.installer.clified_hooks:paint3d_post_install

clified-0.4.0/examples/tools.pc.yaml.example

@@ -0,0 +1,17 @@
+# Exemplo: registrar pc CLI (ProjetoCursor) via Clified
+
+workspace:
+  root: "/home/maikeu/GitClones/ProjetoCursor"
+  name: "ProjetoCursor"
+
+tools:
+  pc:
+    name: "PC CLI"
+    kind: python
+    folder: tools
+    cli_name: pc
+    python_module: pc
+    description: "Flutter + Supabase + deploy — Projeto Cursor"
+    min_python: [3, 10]
+    custom_install: clified_install:custom_install
+    post_install: clified_install:post_install

clified-0.4.0/install.bat

@@ -0,0 +1,34 @@
+@echo off
+REM Clified — Instalador Universal (Windows CMD)
+REM Uso: install.bat <tool> [opcoes]
+
+setlocal EnableDelayedExpansion
+
+set "SCRIPT_DIR=%~dp0"
+set "CLIFIED_ROOT=%SCRIPT_DIR%"
+
+echo Clified — Instalador Universal
+echo =================================
+
+if not exist "%SCRIPT_DIR%tools.yaml" (
+    echo tools.yaml nao encontrado. Copie tools.yaml.example para tools.yaml.
+    exit /b 1
+)
+
+python --version >nul 2>&1
+if errorlevel 1 (
+    set PY=python3
+) else (
+    set PY=python
+)
+
+set "INSTALLER_VENV=%SCRIPT_DIR%.installer-venv"
+set "INSTALLER_PY=%INSTALLER_VENV%\Scripts\python.exe"
+
+if not exist "%INSTALLER_PY%" (
+    %PY% -m venv "%INSTALLER_VENV%"
+    "%INSTALLER_PY%" -m pip install -q --upgrade pip
+    "%INSTALLER_PY%" -m pip install -q -e "%SCRIPT_DIR%"
+)
+
+"%INSTALLER_PY%" -m clified --python %PY% %*

clified-0.4.0/install.ps1

@@ -0,0 +1,70 @@
+# =============================================================================
+# Clified — Instalador Universal (Windows PowerShell)
+# =============================================================================
+
+$ErrorActionPreference = "Stop"
+
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$env:CLIFIED_ROOT = $ScriptDir
+
+$Cyan = "`e[36m"
+$Red = "`e[31m"
+$Reset = "`e[0m"
+
+function Prepare-InstallerEnvironment {
+    Write-Host "${Cyan}Preparando ambiente Clified...${Reset}"
+
+    $toolsYaml = Join-Path $ScriptDir "tools.yaml"
+    if (-not (Test-Path -LiteralPath $toolsYaml)) {
+        Write-Host "${Red}tools.yaml nao encontrado em $ScriptDir${Reset}"
+        Write-Host "  Copie tools.yaml.example para tools.yaml."
+        exit 1
+    }
+
+    $pythonCmd = Get-Command python -ErrorAction SilentlyContinue
+    if (-not $pythonCmd) {
+        $pythonCmd = Get-Command python3 -ErrorAction SilentlyContinue
+    }
+    if (-not $pythonCmd) {
+        Write-Host "${Red}Python 3 nao encontrado.${Reset}"
+        exit 1
+    }
+
+    $py = $pythonCmd.Source
+    & $py -c "import sys; assert sys.version_info >= (3, 10)" 2>$null
+    if ($LASTEXITCODE -ne 0) {
+        Write-Host "${Red}Python 3.10+ necessario.${Reset}"
+        exit 1
+    }
+
+    $installerVenv = Join-Path $ScriptDir ".installer-venv"
+    $launcherPython = Join-Path $installerVenv "Scripts\\python.exe"
+
+    if ((Test-Path -LiteralPath $launcherPython) -and
+        (& $launcherPython -c "import clified, rich, yaml" 2>$null; $LASTEXITCODE -eq 0)) {
+        return @{ Launcher = $launcherPython; Projects = $py }
+    }
+
+    Write-Host "${Cyan}  -> Ambiente do instalador (venv + clified)...${Reset}"
+    if (-not (Test-Path -LiteralPath $launcherPython)) {
+        & $py -m venv $installerVenv
+        if ($LASTEXITCODE -ne 0) { exit 1 }
+    }
+
+    & $launcherPython -m pip install -q --upgrade pip
+    & $launcherPython -m pip install -q -e $ScriptDir
+    if ($LASTEXITCODE -ne 0) { exit 1 }
+
+    return @{ Launcher = $launcherPython; Projects = $py }
+}
+
+$p = Prepare-InstallerEnvironment
+
+$env:UV_VENV_CLEAR = "1"
+$env:UV_LINK_MODE = "copy"
+
+Write-Host "${Cyan}Clified - Instalador Universal${Reset}"
+Write-Host "================================="
+
+& $p.Launcher -m clified --python $p.Projects @args
+exit $LASTEXITCODE