@esquadrao/cli 0.0.0-stage → 1.6.0

package/LICENSE

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

package/README.md

@@ -1,3 +1,367 @@
-# Temporary Holding Version
+# Esquadrão de Conteúdo CLI (`@esquadrao/cli`)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Framework autônomo local e CLI de orquestração de skills, execução de papéis técnicos e produção automatizada de vídeo vertical (9:16) e widescreen (16:9) via FFmpeg, com formato e estilo definidos pelo usuário.
+
+---
+
+## Documentação Canônica e Sincronia de Desenvolvimento
+
+Este repositório (`LuizKarlos/esquadrao_skill`) adota engenharia rigorosa centrada no código e opera sincronizado com o funil de vendas e área de membros (`LuizKarlos/esquadrao_funil`):
+
+- **[`SPEC.md`](./SPEC.md)**: Especificação técnica canônica contendo arquitetura sem dependências obrigatórias (motor local opcional), contratos dos comandos `onboard` e `studio`, soberania de escolha de formato pelo usuário e matriz de papéis.
+- **[`GLOSSARY.md`](./GLOSSARY.md)**: Fonte canônica de terminologia, equivalências técnicas, códigos de saída e matriz anti-delírio.
+- **[`ROADMAP.md`](./ROADMAP.md)**: Esteira viva de engenharia estruturada em 5 fases vinculadas às issues do repositório.
+- **[`Guia Operacional para LLMs`](./skill-media-producer/references/llm-agent-guide.md)**: Playbook completo para agentes inteligentes (Claude, Cursor, Codex, Grok, Hermes) conduzirem onboarding sem alucinações.
+- **[`Catálogo de Templates de Legenda`](./skill-media-producer/references/caption-templates.md)**: Nove presets visuais com fonte, cores, contorno, sombra e medidas, disponíveis via `--caption-template`.
+- **[`Prova de Corte em 3 Níveis`](./skill-media-producer/references/corte-podcast-3-niveis.md)**: Procedimento validado para demonstrar corte de pausas longas e respiros curtos, com métricas e critérios de aceite.
+
+---
+
+## Overview
+
+`@esquadrao/cli` provides a portable, zero-required-dependency bridge to run skills, roles, and tools across any AI coding agent and CLI (local transcription is an optional add-on):
+
+- **Grok Build** (`.agents/skills/`)
+- **Claude Code** (`.claude/skills/`)
+- **Codex CLI** (`.codex/skills/`, `AGENTS.md`)
+- **Cursor** (`.cursor/rules/*.mdc`)
+- **Hermes / VS Code** (`~/.hermes/`, `.vscode/`)
+
+## Requisitos
+
+- **Node.js** >= 18.0.0
+- **FFmpeg & ffprobe** no PATH (obrigatório para renderização de vídeo e comandos de studio/onboard):
+  - **Windows**: `winget install Gyan.FFmpeg` ou `choco install ffmpeg`
+  - **macOS**: `brew install ffmpeg`
+  - **Linux (Debian/Ubuntu)**: `sudo apt update && sudo apt install -y ffmpeg`
+
+## Installation
+
+### Run directly via npx
+```bash
+npx @esquadrao/cli setup
+```
+
+### Install globally via npm
+```bash
+npm install -g @esquadrao/cli
+esquadrao setup
+```
+
+## Commands
+
+```bash
+# Comando principal canônico: esquadrao
+esquadrao onboard [--mode <mode>] [--dest <path>] [--file <file>] [--captions <file.srt>] [--openai] [--local] [--no-captions] [--verbose] [--json]
+
+# Auto-corte integrado: detecta silêncio, expurga pausas e renderiza com QA
+# Legendas: use --captions <file.srt>, --openai (com OPENAI_API_KEY) ou --local (Whisper local opcional)
+esquadrao studio auto-clip <video.mp4> [--captions <file.srt>] [--openai] [--local] [--broll <file>] [--music <file.mp3>] [--layout fullscreen|pip|split_bottom] [--overlay-duration inserts|full] [--silence-thresh -30dB] [--silence-duration 0.8] [--format 9:16] [--caption-style impact]
+
+# Detector rápido de silêncio e pausas mortas
+esquadrao studio detect-silence <video.mp4> [--json]
+
+# Transcrição estruturada para análise de copy (exporta transcript.json e transcript.srt via --openai ou --local)
+esquadrao studio transcribe <video.mp4> [--openai] [--local] [--json]
+
+# Configurar skills nos harnesses locais do usuário (.agents, .claude, .codex, .cursor)
+esquadrao setup [--dest <path>] [--json]
+
+# Inspecionar e executar papéis canônicos
+esquadrao role [list | info <id> | prompt <id> | matrix] [--json]
+
+# Inicializar workspace e importar mídia
+esquadrao studio init [--dest <path>]
+esquadrao studio import <file>
+
+# Renderizar plano manual ou executar QA
+esquadrao studio render <editplan.json>
+esquadrao studio qa <artifact.mp4> [--plan <editplan.json>]
+esquadrao studio cutout <video.mp4> --background <pack.mp4> [--python <interpretador>] [--fps 15]
+```
+
+## Primeiro acesso
+
+O comando `onboard` conduz o cliente do zero até o primeiro vídeo renderizado com validação automatizada de QA. No modo `podcast_clip`, ele executa o pipeline real de `studio auto-clip` (detecção de silêncio, cortes, legendas e QA) e aceita `--captions`, `--openai`, `--local` ou `--no-captions`. Sem qualquer fonte de legenda, aplica `--no-captions` automaticamente, gera o corte real sem legendas e avisa; já o `studio auto-clip` direto, sem `--no-captions`, falha com código `1`.
+
+```bash
+# Fluxo guiado interativo:
+esquadrao onboard
+
+# Execução não interativa com flags:
+esquadrao onboard --mode dark --dest ./workspace
+esquadrao onboard --mode edit_only --file ./raw.mp4 --dest ./workspace
+esquadrao onboard --mode podcast_clip --file ./podcast.mp4 --captions ./podcast.srt --dest ./workspace
+```
+
+### Flags do Onboard:
+- `--mode <podcast_clip | edit_only | dark>`: Modo de vídeo (cortes com legendas, decupagem ou tipografia).
+- `--format <9:16 | 16:9>`: Proporção de tela definida pelo usuário (Vertical 9:16 para mobile ou Widescreen 16:9 para desktop).
+- `--dest <path>`: Diretório do workspace (persiste no perfil para reuso).
+- `--file <path>`: Arquivo de vídeo fonte (pode ser repetido para múltiplos arquivos).
+- `--captions <file.srt>`: Legenda SRT para o modo `podcast_clip`.
+- `--openai`: Usa OpenAI Whisper (requer `OPENAI_API_KEY`).
+- `--local`: Usa o motor local `@xenova/transformers` (opcional).
+- `--no-captions`: Gera o corte sem legendas, de forma explícita.
+- `--verbose`: Exibe logs detalhados do FFmpeg em caso de erro.
+- `--json`: Retorna resultado estruturado em formato JSON.
+
+> **Importante — Soberania do Usuário:** Nem fundo preto (`dark`) nem widescreen (`16:9`) são impostos como padrão. O usuário escolhe a proporção e o estilo de edição.
+
+### Configurar proporção, legendas e áudio
+
+Siga o [guia completo de configuração inicial para Windows / PowerShell](skill-media-producer/references/configuracao-inicial.md): preparação do projeto, importação, plano de edição, formatos vertical/horizontal, legendas, áudio, renderização e QA. A referência acompanha a instalação da `skill-media-producer` e documenta as opções disponíveis e os limites atuais.
+
+### Templates de legenda
+O catálogo canônico tem nove presets sem fundo sólido — MrBeast Yellow, TikTok White, Gold Stroke, Green Stroke, Neon Glitch, Minimal Lower Third, Red Stroke, Heavy White e Mono Clean. Fonte, cores, contorno, sombra e medidas estão em [`caption-templates.md`](skill-media-producer/references/caption-templates.md).
+
+**Disponível no CLI 1.6.0:** use `--caption-template <id>` em `studio auto-clip`/`studio render` ou `captions[].template` no EditPlan. `--caption-style impact|word|full` continua como legado.
+
+## Estrutura do workspace
+
+Ao inicializar o estúdio via `esquadrao studio init` (ou no primeiro uso via `onboard`), a seguinte árvore de diretórios é criada:
+
+```
+workspace/
+├── assets/       # Mídias brutas e assets importados (vídeos, áudios, b-rolls)
+├── packages/     # Planos de corte e edição gerados (editplan.json)
+├── artifacts/    # Vídeos finais renderizados (.mp4); QA é emitido em JSON/stdout
+└── studio.json   # Manifesto do estúdio e inventário de assets registrados
+```
+
+## Exemplos de EditPlan por Modo
+
+### 1. Modo `dark` (zero footage, textos/overlays):
+```json
+{
+  "schema_version": 1,
+  "mode": "dark",
+  "clips": [
+    {
+      "kind": "text",
+      "text": "Esquadrão Onboarding",
+      "duration_ms": 1000,
+      "timeline_start_ms": 0
+    }
+  ],
+  "output": {
+    "width": 1080,
+    "height": 1920,
+    "fps_num": 30,
+    "fps_den": 1,
+    "video_codec": "h264",
+    "audio_codec": "aac"
+  }
+}
+```
+
+### 2. Modo `edit_only` (2 cortes contíguos de fontes de vídeo):
+```json
+{
+  "schema_version": 1,
+  "mode": "edit_only",
+  "clips": [
+    {
+      "kind": "video",
+      "asset_id": "AST-12345678",
+      "clip_id": "c1",
+      "in_ms": 0,
+      "out_ms": 500,
+      "timeline_start_ms": 0,
+      "speed": 1
+    },
+    {
+      "kind": "video",
+      "asset_id": "AST-12345678",
+      "clip_id": "c2",
+      "in_ms": 500,
+      "out_ms": 1000,
+      "timeline_start_ms": 500,
+      "speed": 1
+    }
+  ],
+  "audio_tracks": [
+    { "kind": "source", "clip_id": "c1", "gain_db": 0 },
+    { "kind": "source", "clip_id": "c2", "gain_db": 0 }
+  ],
+  "output": {
+    "width": 1080,
+    "height": 1920,
+    "fps_num": 30,
+    "fps_den": 1,
+    "video_codec": "h264",
+    "audio_codec": "aac"
+  }
+}
+```
+
+### 3. Modo `podcast_clip` (>= 1 corte com legendas visuais):
+```json
+{
+  "schema_version": 1,
+  "mode": "podcast_clip",
+  "clips": [
+    {
+      "kind": "video",
+      "asset_id": "AST-12345678",
+      "clip_id": "c1",
+      "in_ms": 0,
+      "out_ms": 1000,
+      "timeline_start_ms": 0,
+      "speed": 1
+    }
+  ],
+  "audio_tracks": [
+    { "kind": "source", "clip_id": "c1", "gain_db": 0 }
+  ],
+  "captions": [
+    {
+      "text": "Esquadrão Podcast Clip",
+      "timeline_start_ms": 0,
+      "duration_ms": 1000
+    }
+  ],
+  "output": {
+    "width": 1080,
+    "height": 1920,
+    "fps_num": 30,
+    "fps_den": 1,
+    "video_codec": "h264",
+    "audio_codec": "aac"
+  }
+}
+```
+
+### 4. Modo `podcast_clip` dinâmico (com B-Rolls, Trilha Sonora e Ducking):
+```json
+{
+  "schema_version": 1,
+  "mode": "podcast_clip",
+  "clips": [
+    {
+      "kind": "video",
+      "clip_id": "orador-01",
+      "asset_id": "AST-PODCAST01",
+      "in_ms": 15000,
+      "out_ms": 45000,
+      "timeline_start_ms": 0,
+      "speed": 1
+    }
+  ],
+  "audio_tracks": [
+    { "kind": "source", "clip_id": "orador-01", "gain_db": 0 }
+  ],
+  "overlays": [
+    {
+      "asset_id": "AST-BROLL01",
+      "layout": "fullscreen",
+      "in_ms": 0,
+      "out_ms": 3000,
+      "timeline_start_ms": 5000,
+      "duration_ms": 3000
+    }
+  ],
+  "music_tracks": [
+    {
+      "asset_id": "AST-TRILHA01",
+      "gain_db": -22,
+      "ducking": true
+    }
+  ],
+  "captions": [
+    {
+      "text": "O MAIOR SEGREDO",
+      "timeline_start_ms": 0,
+      "duration_ms": 1500,
+      "style": "impact"
+    }
+  ],
+  "output": {
+    "width": 1080,
+    "height": 1920,
+    "fps_num": 30,
+    "fps_den": 1,
+    "video_codec": "h264",
+    "audio_codec": "aac"
+  }
+}
+```
+
+## Industry Roles Matrix
+
+All roles follow standardized industry nomenclature, structural authority boundaries, and zero-dependency contract validation:
+
+| Role ID | Title | Access | Description |
+| :--- | :--- | :--- | :--- |
+| `product-manager` | Product Manager | Read/Write | Requirements contracts, bounded scope, acceptance criteria |
+| `system-analyst` | Systems Analyst | Read-Only | Repository mapping, dependency graphs, architectural recon |
+| `software-architect` | Principal Software Architect | Read/Write | System decomposition, interface invariants, rollback criteria |
+| `tech-lead` | Technical Lead | Read/Write | Architectural adjudication, technical trade-offs, standard enforcement |
+| `security-engineer` | Security Engineer | Read-Only | Adversarial threat modeling, vulnerability auditing, boundary checks |
+| `software-engineer` | Senior Software Engineer | Read/Write | Production code implementation, unit tests, minimal working diffs |
+| `code-reviewer` | Code Reviewer | Read-Only | Independent peer review, anti-slop linting, anti-self-review guard |
+| `sre-engineer` | Site Reliability Engineer | Read/Write | Failure diagnosis, root cause analysis (RCA), fix contracts |
+| `qa-engineer` | QA Engineer | Read-Only | Release verification, operational criteria check, terminal gates |
+| `technical-writer` | Technical Writer | Read/Write | Developer guides, API documentation, changelogs, ADR records |
+| `engineering-manager` | Engineering Manager | Read/Write | Milestone roadmaps, sprint backlogs, follow-up task generation |
+| `media-producer` | Media Producer | Read/Write | Video edit plans, timeline cuts (>=100ms), NFC text, media QA |
+
+## Skills Matrix
+
+| Skill | Description |
+| :--- | :--- |
+| `skill-orchestrate` | Autonomous missions, multi-agent swarms, atomic checkpoints, and rollbacks |
+| `skill-pipeline` | DAG decomposition, topological wave calculation, and auto-healing |
+| `skill-review` | Adversarial dual-blind code review, anti-slop pattern linting, and voice calibration |
+| `skill-audit` | SHA-256 Merkle chain integrity, receipt verification, and time-travel replay |
+| `skill-context` | AST outline slicing, OpenAPI 3.1 contract synthesis, and context packets <3k tokens |
+| `skill-ui` | Headless WCAG 2.1 AA/AAA contrast check, 44x44px touch targets, and visual TDD |
+| `skill-product-manager` | Requirements synthesis, scope boundaries, and acceptance criteria |
+| `skill-system-analyst` | Read-only codebase reconnaissance, dependency mapping, and touchpoints |
+| `skill-software-architect` | Architectural contracts, system invariants, and rollback conditions |
+| `skill-tech-lead` | Proposal arbitration, technical debt evaluation, and engineering guidelines |
+| `skill-security-engineer` | Threat modeling, injection and privilege audit, fail-closed enforcement |
+| `skill-software-engineer` | Implementation of atomic patches and focused unit tests |
+| `skill-code-reviewer` | Independent diff review, anti-slop inspection, and anti-self-review |
+| `skill-sre-engineer` | Root-cause analysis (RCA) and deterministic fix contracts |
+| `skill-qa-engineer` | Final operational release gates and acceptance certification |
+| `skill-technical-writer` | Developer guides, ADR documentation, and changelog authoring |
+| `skill-engineering-manager` | Milestone derivations, sprint task backlogs, and agile planning |
+| `skill-media-producer` | Video timeline cuts, audio gain leveling, NFC text overlays, media QA |
+
+## Standalone Scripts
+
+All scripts run directly with Node.js stdlib (zero dependencies):
+
+- `node scripts/dag_validator.js tasks.json` - Validates DAG acyclicity and computes topological waves.
+- `node scripts/merkle_verify.js ledger.json` - Verifies cryptographic continuity of Merkle blocks.
+- `node scripts/ast_slice.js src/app.js` - Extracts structural AST signatures reducing tokens by >60%.
+- `node scripts/wcag_check.js --fg="#000" --bg="#fff"` - Checks WCAG contrast ratios and target sizes.
+
+## Limitações atuais
+
+- **Legendas automáticas:** a transcrição no `studio auto-clip` e `studio transcribe` depende de SRT (`--captions <file.srt>`), da API OpenAI (`--openai` com `OPENAI_API_KEY`) ou do motor local (`--local`, `@xenova/transformers` em `optionalDependencies`). Sem nenhum deles, o comando falha com código `1` e instrução acionável; use `--no-captions` para gerar o corte explicitamente sem legendas (CLI-02/CLI-03 resolvidos em 1.4.0).
+- **Sem processamento em lote nativo:** não há comando `batch`; renderizações em lote devem ser orquestradas externamente via chamadas sucessivas de `esquadrao studio render`.
+- **Ducking de áudio fixo:** a opção `ducking: true` em `music_tracks` aplica atenuação fixa de volume em `-22dB` via filtro `amix`; ducking dinâmico via sidechain está pendente de implementação (CLI-05).
+- **Layout de overlay `split_top`:** embora aceito na validação do schema do EditPlan, o pipeline de renderização trata apenas `fullscreen`, `pip` e `split_bottom`; overlays com `split_top` são renderizados como tela cheia (`fullscreen`) (CLI-06).
+- **Split permanente:** disponível em `auto-clip --broll <pack> --layout split_bottom --overlay-duration full`; o pack cobre toda a linha do tempo em loop e o áudio original é preservado (CLI-13). `split_top` continua pendente (CLI-06).
+- **Recorte de pessoa com troca de fundo:** `studio cutout` é experimental e exige Python com `rembg`, `onnxruntime`, `opencv-python-headless` e `numpy`; sem isso, falha com instrução. Saída 9:16, 15 fps por padrão, ~18–20 min de CPU por 60 s. Sem cache de máscaras ou GPU nesta versão. Detalhes em [`skill-media-producer/references/composicoes-especiais.md`](./skill-media-producer/references/composicoes-especiais.md).
+- **Alias legado no package.json:** o binário canônico oficial é `esquadrao`; o alias `esquadrao-skill` ainda consta no campo `bin` do `package.json` para compatibilidade retroativa e sua remoção está mapeada em backlog (CLI-09).
+
+## Testing
+
+Run the native test suite:
+```bash
+npm test
+```
+
+## License
+
+MIT
+
+---
+
+## 🛡️ Auditoria Atlas MCP & Jev: Sanitização Concluída
+
+> **AVISO DE CONFORMIDADE:** A etapa de produção de tutoriais está **CONFORME E LIBERADA**.
+> Sanitização de nomes de pacotes (`@esquadrao/cli`), binários (`esquadrao`) e manifestos (`esquadrao-studio`) executada com sucesso. Erradicação de 100% dos termos legados.

package/assets/fonts/OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The Anton Project Authors (https://github.com/googlefonts/AntonFont.git)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/assets/fonts/README.md

@@ -0,0 +1,13 @@
+# Fontes empacotadas
+
+Estas fontes são distribuídas com o `@esquadrao/cli` para que os templates de legenda tenham o mesmo desenho em qualquer sistema.
+
+| Arquivo | Família | Origem | Licença |
+| :--- | :--- | :--- | :--- |
+| `Anton-Regular.ttf` | Anton | [Google Fonts](https://fonts.google.com/specimen/Anton) | SIL Open Font License 1.1 |
+| `BebasNeue-Regular.ttf` | Bebas Neue | [Google Fonts](https://fonts.google.com/specimen/Bebas+Neue) | SIL Open Font License 1.1 |
+| `Poppins-Bold.ttf` | Poppins | [Google Fonts](https://fonts.google.com/specimen/Poppins) | SIL Open Font License 1.1 |
+
+O texto integral da licença está em [`OFL.txt`](./OFL.txt).
+
+Liberation Sans Bold e DejaVu Sans Mono Bold são resolvidas do sistema operacional; quando ausentes, o CLI usa `Poppins-Bold.ttf` como fallback.

package/bin/cli.js

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+import { parseArgs } from 'node:util';
+import { existsSync, readFileSync } from 'node:fs';
+import process from 'node:process';
+
+if (typeof process.loadEnvFile === 'function' && existsSync('.env')) {
+  try { process.loadEnvFile(); } catch {}
+}
+
+const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+
+const { values: flags, positionals } = parseArgs({
+  args: process.argv.slice(2),
+  options: {
+    json: { type: 'boolean' },
+    dest: { type: 'string' },
+    mode: { type: 'string' },
+    file: { type: 'string', multiple: true },
+    plan: { type: 'string' },
+    verbose: { type: 'boolean' },
+    help: { type: 'boolean', short: 'h' },
+    version: { type: 'boolean', short: 'v' },
+    format: { type: 'string' },
+    'silence-thresh': { type: 'string' },
+    'silence-duration': { type: 'string' },
+    'caption-style': { type: 'string' },
+    openai: { type: 'boolean' },
+    local: { type: 'boolean' },
+    captions: { type: 'string' },
+    'caption-template': { type: 'string' },
+    'no-captions': { type: 'boolean' },
+    broll: { type: 'string', multiple: true },
+    music: { type: 'string' },
+    layout: { type: 'string' },
+    'overlay-duration': { type: 'string' },
+    background: { type: 'string' },
+    engine: { type: 'string' },
+    fps: { type: 'string' },
+    python: { type: 'string' },
+    'min-dur': { type: 'string' },
+    'max-dur': { type: 'string' },
+  },
+  allowPositionals: true,
+  strict: false,
+});
+
+const command = positionals[0];
+
+if (flags.version || command === 'version' || flags.v) {
+  console.log(pkg.version);
+  process.exit(0);
+}
+
+const SUBCOMMANDS = new Set(['setup', 'role', 'studio', 'onboard']);
+
+if (!command || command === 'help' || (flags.help && !SUBCOMMANDS.has(command))) {
+  console.log(`Esquadrão CLI v${pkg.version}
+
+Usage:
+  esquadrao <command> [options]
+
+Commands:
+  setup       Instala os skills nos ambientes de agentes (.agents, .claude, .codex, .cursor)
+  role        Lista, inspeciona e executa papéis canônicos da esteira
+  studio      Estúdio local de vídeo: init, import, render, qa, auto-clip, cutout, caption-templates
+  onboard     Guia interativo: da mídia bruta ao primeiro corte renderizado
+  version     Exibe a versão do CLI
+  help        Exibe mensagens de ajuda
+
+Options:
+  -h, --help                Show help
+  -v, --version             Show version
+  --json                    Output results in JSON format
+  --dest <path>             Custom destination directory for skills or workspace
+  --mode <mode>             Video mode for onboarding (edit_only, dark, podcast_clip)
+  --file <path>             Source media file for onboarding (can be repeated)
+  --format <9:16|16:9>      Aspect ratio (padrão: 9:16)
+  --silence-thresh <dB>     Sensibilidade de silêncio (padrão: -30dB)
+  --silence-duration <sec>  Pausa mínima para corte (padrão: 0.8s)
+  --caption-style <style>   Estilo de legendas: impact (padrão), word, full
+  --openai                  Usar API OpenAI Whisper para transcrição
+  --local                   Usar Whisper local (offline)
+  --captions <file.srt>     Arquivo de legendas externo
+  --caption-template <id>   Template de legenda (ver studio caption-templates)
+  --no-captions             Gerar corte sem legendas (pula transcrição)
+  --broll <file>            Arquivo de B-roll/cena de apoio (pode ser repetido)
+  --music <file.mp3>        Arquivo de música de fundo para ducking
+  --layout <layout>         Layout do B-roll: fullscreen, pip ou split_bottom
+  --overlay-duration <mode> inserts (2-4s) ou full (todo o clipe)
+  --background <file>       Pack de fundo para studio cutout
+  --engine <rembg>          Motor de recorte de pessoa (padrão: rembg)
+  --fps <n>                 FPS do recorte (padrão: 15)
+  --python <path>           Interpretador Python para o motor de recorte
+  --min-dur <sec>           Duração mínima para detecção de gancho (padrão: 30)
+  --max-dur <sec>           Duração máxima para detecção de gancho (padrão: 60)`);
+  process.exit(0);
+}
+
+if (!SUBCOMMANDS.has(command)) {
+  console.error(`Unknown command: '${command}'. Run 'esquadrao --help' for available commands.`);
+  process.exit(1);
+}
+
+// ponytail: direct file resolution for command modules; upgrade when complex routing needed.
+const candidates = [
+  new URL(`../src/commands/${command}.js`, import.meta.url),
+  new URL(`../src/${command}.js`, import.meta.url),
+];
+const target = candidates.find((url) => existsSync(url));
+
+if (!target) {
+  console.error(`Command '${command}' is not yet implemented.`);
+  process.exit(1);
+}
+
+try {
+  const mod = await import(target.href);
+  const handler = mod.run || mod.default || mod[command];
+  if (typeof handler !== 'function') {
+    throw new Error(`Command module '${command}' does not export a runnable function.`);
+  }
+  await handler({ positionals: positionals.slice(1), flags });
+} catch (err) {
+  console.error(`Error executing '${command}':`, err.message);
+  process.exit(1);
+}