@jaimevalasek/aioson 1.4.0 → 1.6.0

package/docs/pt/skills.md

@@ -36,19 +36,27 @@ Estrutura:
 │   ├── ethereum-docs.md
 │   ├── solana-docs.md
 │   └── cardano-docs.md
-└── design/          ← design systems visuais
-    ├── cognitive-core-ui/
-    ├── interface-design/
-    └── premium-command-center-ui/
+├── design/          ← design systems visuais
+│   ├── cognitive-core-ui/
+│   ├── interface-design/
+│   └── premium-command-center-ui/
+└── process/         ← metodologia de fluxo e contratos entre agentes
+    └── aioson-spec-driven/
 ```
 
 **Carregamento condicional:** O agente `@dev` carrega apenas as skills que correspondem ao valor de `framework` em `project.context.md`. Exemplo: se `framework=Laravel`, carrega `laravel-conventions.md` e opcionalmente `tall-stack-patterns.md` se o stack for TALL.
 
+**Process skills** são carregadas pelos agentes de spec (`@product`, `@analyst`, `@architect`, `@sheldon`, `@dev`, `@deyvin`) no início de sessões de especificação, requirements e design — nunca todas de uma vez. Cada agente carrega o `SKILL.md` central e depois apenas o arquivo de `references/` relevante para sua fase atual.
+
 ### Skills instaladas (`.aioson/installed-skills/`)
 
-Skills de terceiros instaladas pelo usuário. São **versionadas com o projeto** (não gitignored), permitindo que toda a equipe use as mesmas skills.
+Skills versionadas com o projeto. Entram aqui em dois casos:
+
+- skills de terceiros instaladas pelo usuário via CLI
+- skills locais geradas dentro do próprio projeto por agentes/process skills
 
 Cada skill instalada contém um `SKILL.md` com frontmatter YAML descrevendo quando usá-la.
+Quando existir, o arquivo `.skill-meta.json` registra origem, autor e metadados do gerador/modelo.
 
 ## Instalando skills
 
@@ -61,7 +69,7 @@ aioson skill:install @tech-leads-club/agent-skills --skill coupling-analysis
 Isso:
 1. Baixa o pacote npm temporariamente
 2. Copia a skill para `.aioson/installed-skills/{nome}/`
-3. Distribui para ferramentas nativas (`.claude/skills/`, `.cursor/skills/`, `.windsurf/skills/`)
+3. Distribui recursivamente para ferramentas nativas (`.claude/skills/`, `.cursor/skills/`, `.windsurf/skills/`)
 4. Registra a skill na seção "Installed skills" do `AGENTS.md`
 
 ### Via aioson.com (registry cloud)
@@ -89,6 +97,7 @@ aioson skill:list
 ```
 
 Mostra todas as skills em `.aioson/installed-skills/` com nome, descrição e fonte.
+Quando a metadata existir, também pode mostrar autor e modelo gerador.
 
 ### Remover uma skill
 
@@ -150,6 +159,89 @@ Skills de design disponíveis:
 - `interface-design` — Design de interfaces (dashboards, apps, ferramentas)
 - `premium-command-center-ui` — UI premium para command centers
 
+## Skills de processo
+
+Skills de processo ensinam os agentes **como as fases do AIOSON se conectam** — não o que implementar, mas como sequenciar, quando aprofundar e como fazer handoff limpo entre agentes.
+
+Diferente das skills de framework (que são por stack) e das skills de design (que são por sistema visual), process skills são transversais: carregadas por qualquer agente de spec conforme a fase em que ele se encontra.
+
+### `aioson-spec-driven`
+
+Localização: `.aioson/skills/process/aioson-spec-driven/`
+
+A skill central de metodologia do AIOSON. Cobre:
+
+- **Sequência de fases** — quais fases existem, quais artefatos cada uma produz e quem é o agente responsável
+- **Profundidade por classificação** — MICRO usa fluxo mínimo, SMALL usa fluxo padrão, MEDIUM usa pacote completo
+- **Gates de aprovação** — Gate A (requirements), Gate B (design), Gate C (plan) — critérios do que deve estar pronto antes de avançar para a próxima fase
+- **Hardening lane** — como identificar quando um input ainda está em modo "exploratório/vibe" e o que fazer para convertê-lo em spec executável
+- **Manutenção e estado** — como escrever checkpoints úteis em `spec-{slug}.md` para que qualquer agente ou sessão futura possa retomar sem redescobrir o que já foi decidido
+
+**Estrutura:**
+
+```
+.aioson/skills/process/aioson-spec-driven/
+├── SKILL.md                          ← entry point curto — carregue sempre primeiro
+└── references/
+    ├── artifact-map.md               ← qual artefato fica onde e quem é o dono
+    ├── classification-map.md         ← profundidade de fase por MICRO/SMALL/MEDIUM
+    ├── approval-gates.md             ← critérios dos Gates A, B e C
+    ├── hardening-lane.md             ← quando endurecer vs quando explorar
+    └── maintenance-and-state.md      ← como escrever spec e checkpoints úteis
+```
+
+**Carregamento:** Os agentes `@product`, `@analyst`, `@architect`, `@sheldon`, `@dev` e `@deyvin` verificam automaticamente se esta skill está disponível e carregam `SKILL.md` + apenas o arquivo de `references/` relevante para a fase atual. Nunca carregam a pasta inteira de uma vez.
+
+### `design-hybrid-forge`
+
+Localização: `.aioson/skills/process/design-hybrid-forge/`
+
+Skill first-party para criar uma nova skill de design híbrida a partir de **2 skills primárias obrigatórias** e, opcionalmente, até 2 modificadores de escopo limitado. Em modo avançado, pode liberar um 3º modificador, ainda preso a lanes secundárias.
+
+Se você quer o fluxo completo em um só lugar, leia a página dedicada: [design-hybrid-forge](./design-hybrid-forge.md).
+
+Fluxo padrão:
+
+1. O usuário ativa `@design-hybrid-forge` no Codex ou `/design-hybrid-forge` no Claude
+2. Se quiser um overlay visual mais ousado, o usuário pode rodar `aioson design-hybrid:options` para gerar `.aioson/context/design-variation-preset.md`
+3. O comando usa `conversation_language` do projeto quando existir; `--locale` funciona como override manual
+4. O agente pede as 2 skills primárias, até 2 modificadores opcionais e lê o preset visual quando ele existir
+5. Se o usuário tiver criado o preset com `--advanced`, o agente pode aceitar um 3º modificador de escopo estreito
+6. O híbrido é gerado em `.aioson/installed-skills/{slug}/`
+7. O `AGENTS.md` é atualizado para que o Codex possa usar `@{slug}`
+8. O pacote também pode ser espelhado para `.claude/skills/`, `.cursor/skills/` e `.windsurf/skills/`
+
+Saída padrão:
+
+```
+.aioson/installed-skills/{slug}/
+  SKILL.md
+  .skill-meta.json
+  references/
+  previews/
+```
+
+Esse fluxo cria uma **skill local do projeto**. Se depois você quiser promover a skill para o core do AIOSON ou para um marketplace, trate isso como uma segunda etapa de curadoria, separada da geração local.
+
+O preset criado em `.aioson/context/design-variation-preset.md` é **temporário**:
+- ele serve como input para a próxima geração híbrida
+- depois da geração, deve ser removido ou movido do contexto ativo
+- uma cópia histórica fica em `.aioson/context/history/design-variation-presets/`
+- ele não redefine o layout padrão do projeto; quem continua mandando no projeto é a `design_skill` ativa
+
+O preset gerado por `design-hybrid:options` cobre direções como:
+- clássico / editorial
+- extravagante / maximalista
+- cinematográfico / imersivo
+- retrofuturista
+- motion-driven
+- CSS avançado (scroll-driven animations, View Transition API, masks, SVG filters, 3D)
+
+Recomendação de uso:
+- fluxo normal: até 2 modificadores
+- fluxo avançado: `aioson design-hybrid:options --advanced` para permitir até 3 modificadores
+- mesmo no modo avançado, modificadores não podem dominar substrato nem estrutura
+
 ## Skills de squad
 
 Squads podem ter suas próprias skills em `.aioson/squads/{squad-slug}/skills/`. Essas são carregadas automaticamente quando a tarefa pertence ao escopo do squad.

package/docs/pt/squad-dashboard.md

@@ -0,0 +1,373 @@
+# Squad Dashboard
+
+O Squad Dashboard é um painel web embutido no próprio CLI do aioson. Ele roda localmente no computador do desenvolvedor e permite acompanhar todos os squads de um projeto em tempo real — agentes, processos ativos, uso de contexto, tokens, logs de execução e métricas.
+
+Não requer instalação adicional. Vem incluso quando você instala o aioson.
+
+---
+
+## Pré-requisitos
+
+- aioson instalado globalmente (`npm install -g @jaimevalasek/aioson`)
+- Pelo menos um squad criado no projeto (`aioson squad:create`)
+- Node.js ≥ 18 (já exigido pelo aioson)
+- Browser moderno (Chrome, Firefox, Safari, Edge)
+
+---
+
+## Iniciando
+
+Na raiz do projeto (onde fica a pasta `.aioson/`):
+
+```bash
+aioson squad:dashboard
+```
+
+Saída esperada:
+```
+Squad Dashboard rodando em http://localhost:4180 (porta 4180)
+Pressione Ctrl+C para parar.
+```
+
+Abra `http://localhost:4180` no browser. Para encerrar, pressione `Ctrl+C` no terminal.
+
+---
+
+## Opções
+
+```bash
+aioson squad:dashboard [path] [--port=4180] [--squad=<slug>] [--locale=pt-BR]
+```
+
+| Opção | Padrão | Descrição |
+|-------|--------|-----------|
+| `path` | `.` (diretório atual) | Raiz do projeto aioson |
+| `--port` | `4180` | Porta HTTP do dashboard |
+| `--squad` | — | Abre diretamente na página de um squad específico |
+| `--locale` | `pt-BR` | Idioma da interface |
+
+---
+
+## Exemplos
+
+### Iniciar na raiz do projeto atual
+```bash
+cd ~/meus-projetos/clinica-odonto
+aioson squad:dashboard
+```
+
+### Iniciar em outra porta
+```bash
+aioson squad:dashboard --port=4200
+```
+
+### Apontar para projeto em outro diretório
+```bash
+aioson squad:dashboard /home/usuario/projetos/marketing-digital
+```
+
+### Abrir diretamente em um squad específico
+```bash
+aioson squad:dashboard --squad=marketing-odonto
+# → Redireciona automaticamente para http://localhost:4180/squad/marketing-odonto
+```
+
+### Múltiplos projetos ao mesmo tempo (portas diferentes)
+```bash
+# Terminal 1
+aioson squad:dashboard ~/projetos/clinica --port=4180
+
+# Terminal 2
+aioson squad:dashboard ~/projetos/ecommerce --port=4181
+```
+
+---
+
+## Navegando pelo Dashboard
+
+### Página inicial — Lista de squads
+
+Ao acessar `http://localhost:4180`, você vê todos os squads do projeto com:
+
+- Nome e modo do squad (`content`, `software`, `mixed`)
+- Número de executores (agentes)
+- Status atual
+- Link para entrar na página do squad
+
+Se nenhum squad aparecer, verifique se existe `.aioson/squads/*/squad.manifest.json` no projeto.
+
+---
+
+### Página do squad — Painéis
+
+Cada squad tem sua própria URL: `http://localhost:4180/squad/{slug}`
+
+Os painéis disponíveis variam conforme a configuração do squad:
+
+#### Painel: Overview
+
+Visão resumida do squad:
+- Total de itens de conteúdo produzidos
+- Número de sessões registradas
+- Learnings acumulados
+- Taxa de entrega
+- Plano de execução (se definido)
+- Informações de pipeline
+
+#### Painel: Agentes (Processos)
+
+Lista os agentes Claude/AI ativos no momento:
+
+| Coluna | O que mostra |
+|--------|-------------|
+| Agente | Slug do executor |
+| PID | ID do processo no sistema operacional |
+| Tempo | Duração da sessão atual (`HH:MM:SS`) |
+| Contexto | Porcentagem do context window usado |
+| URL | Link para abrir a sessão do AI (se disponível) |
+| Ação | Botão para encerrar o processo via SIGTERM |
+
+> Os dados de processos atualizam automaticamente a cada 5 segundos via SSE (Server-Sent Events).
+
+#### Painel: Contexto
+
+Monitor do context window de cada agente em execução:
+
+- **Gauge visual** mostrando % de uso do contexto
+- **Nível de alerta**:
+  - Verde: 0–84% → Normal
+  - Amarelo: 85–94% → Warning
+  - Vermelho: 95–99% → Critical
+  - Roxo: 100%+ → Overflow
+- Detecção automática de compact (queda > 30% indica que o contexto foi compactado)
+- Breakdown por categoria (system prompt, conversation history, tool outputs, etc.)
+
+#### Painel: Tokens
+
+Uso e custo estimado por agente:
+
+- Total de tokens consumidos na sessão
+- Custo estimado em USD (baseado em modelo Sonnet-class)
+- **Flag de desperdício**: aparece quando `tool_outputs > 60%` do total
+- Breakdown por categoria (input, output, tool_use_input, tool_outputs, cache_write, cache_read)
+
+#### Painel: Logs de Execução
+
+Histórico detalhado das execuções de tasks:
+
+- Entradas filtráveis por tipo:
+  - `tool_call` — chamadas de ferramentas com input/output
+  - `reasoning` — raciocínio do agente
+  - `milestone` — marcos importantes
+  - `error` — erros com stack trace (quando disponível)
+- Timeline ordenada por timestamp
+- Filtro por sessão
+
+#### Painel: Hunk Review
+
+Revisão de código em hunks (para squads de software):
+
+- Lista de hunks pendentes de revisão
+- Ações disponíveis: **Aprovar**, **Rejeitar** (com comentário obrigatório), **Comentar**
+- Progresso: `aprovados / rejeitados / pendentes / revisados`
+- Re-submit: hunks aprovados mantêm status; só rejeitados voltam para pendente
+
+#### Painel: Content
+
+Itens de conteúdo produzidos pelo squad (para squads de conteúdo):
+
+- Lista de outputs indexados
+- Tipo e layout de cada item
+- Agente responsável
+
+#### Painel: Learnings
+
+Aprendizados acumulados pelo squad:
+
+- Learnings ativos, stale e archived
+- Tipo: preference, process, domain, quality
+- Confiança: high, medium, low
+
+#### Painel: Métricas
+
+Métricas customizadas configuradas via `aioson squad:roi`:
+
+- Valor atual vs. baseline vs. target
+- Período
+- Barra de progresso visual
+- ROI calculado (quando configurado)
+
+#### Painel: Integrações
+
+Status dos MCPs configurados no squad:
+
+- Connectors ativos (WhatsApp, Telegram, Webhook, etc.)
+- Status: connected / unconfigured / error
+- Calls totais e falhas
+
+#### Painel: Recovery Context
+
+Contexto de recovery gerado para cada agente (injeção pós-compact):
+
+- Conteúdo do `recovery-context.md`
+- Estimativa de tokens
+- Quando foi gerado
+
+---
+
+## Casos de Uso por Tipo de Squad
+
+### Squad de Conteúdo (ex: Clínica Odontológica)
+
+```bash
+# A squad está gerando conteúdo para Instagram e blog
+aioson squad:dashboard --squad=marketing-odonto
+
+# Painéis mais relevantes:
+# → Content: ver posts gerados
+# → Agentes: ver compositor e estrategista rodando
+# → Learnings: preferências de tom e formato acumuladas
+```
+
+### Squad de Software (ex: Feature de Agendamento)
+
+```bash
+aioson squad:dashboard --squad=agendamento-v2
+
+# Painéis mais relevantes:
+# → Hunk Review: revisar código antes de merge
+# → Logs: acompanhar tool_calls do agente de código
+# → Contexto: monitorar se o agente está perto do limite
+```
+
+### Squad com Workers e Daemon
+
+```bash
+# Primeiro inicie o daemon (workers automáticos)
+aioson squad:daemon start --squad=clinica
+
+# Em outro terminal, levante o dashboard
+aioson squad:dashboard --squad=clinica
+
+# Painéis mais relevantes:
+# → Métricas: taxa de no-show, ROI
+# → Integrações: status do WhatsApp Business
+# → Agentes: ver processos em tempo real
+```
+
+---
+
+## Integração com outros comandos
+
+O dashboard lê dados gerados por outros comandos do aioson. Para que os painéis mostrem dados ricos:
+
+| Para ver no dashboard | Comando que gera os dados |
+|-----------------------|--------------------------|
+| Métricas e ROI | `aioson squad:roi metric --squad=X` |
+| Status de MCPs | `aioson squad:mcp configure --squad=X` |
+| Processos ativos | Agentes rodando que gravam em `.aioson/squads/{slug}/processes/` |
+| Context window | Agentes que gravam em `.aioson/squads/{slug}/context-monitor.json` |
+| Token usage | Agentes que gravam em `.aioson/squads/{slug}/token-usage.json` |
+| Learnings | `aioson squad:learning` e sessões registradas automaticamente |
+| Recovery context | `aioson squad:recovery --squad=X --agent=Y` |
+
+---
+
+## Requisitos de Dados no Projeto
+
+O dashboard funciona mesmo sem todos os dados. O que cada painel precisa:
+
+```
+.aioson/
+  squads/
+    {slug}/
+      squad.manifest.json          ← obrigatório (o squad aparece na lista)
+      context-monitor.json         ← painel Contexto
+      token-usage.json             ← painel Tokens
+      processes/
+        {agent}.json               ← painel Agentes
+      recovery-context.md          ← painel Recovery
+      attachments/                 ← painel Attachments
+  runtime/
+    aios.sqlite                    ← painéis Content, Learnings, Métricas, Integrações
+```
+
+Se o SQLite não existir, os painéis que dependem dele aparecem vazios mas o dashboard não quebra.
+
+---
+
+## Diferença entre Squad Dashboard e aioson-dashboard
+
+| | Squad Dashboard | aioson-dashboard |
+|---|---|---|
+| **O que é** | Servidor HTTP embutido no CLI | App Next.js installável (premium) |
+| **Como acessa** | `aioson squad:dashboard` | Instala e roda separado |
+| **Foco** | Squads do projeto em tempo real | Gestão geral — projetos, genomas, pipelines, cloud |
+| **Porta** | `localhost:4180` (configurável) | Definida pelo app |
+| **Requer instalação extra** | Não — vem com o aioson | Sim |
+| **Custo** | Gratuito | Premium |
+
+Quando ambos estão rodando, o aioson-dashboard exibe um botão **"Abrir Squad Dashboard"** na página de cada squad, abrindo diretamente a URL correta.
+
+---
+
+## Solução de Problemas
+
+### O dashboard não inicia — porta em uso
+
+```
+Porta 4180 ja esta em uso. Tente --port=<outra>
+```
+
+Use outra porta:
+```bash
+aioson squad:dashboard --port=4200
+```
+
+### Nenhum squad aparece na home
+
+Verifique se o manifest existe:
+```bash
+ls .aioson/squads/*/squad.manifest.json
+```
+
+Se não existir, crie o squad primeiro:
+```bash
+aioson squad:create . --squad=meu-squad
+```
+
+### Painéis aparecem vazios
+
+Normal para projetos novos ou squads sem dados de runtime. Os painéis populam conforme os agentes rodam e gravam dados.
+
+### Processo aparece mas não atualiza
+
+O painel de agentes usa SSE com intervalo de 5 segundos. Se parar de atualizar, recarregue a página.
+
+### Comando não encontrado após atualizar o aioson no projeto
+
+O binário global pode estar desatualizado:
+```bash
+npm update -g @jaimevalasek/aioson
+```
+
+---
+
+## Referência rápida
+
+```bash
+# Iniciar
+aioson squad:dashboard
+
+# Porta customizada
+aioson squad:dashboard --port=4200
+
+# Squad específico
+aioson squad:dashboard --squad=meu-squad
+
+# Projeto em outro diretório
+aioson squad:dashboard /path/do/projeto
+
+# Ver ajuda
+aioson squad:dashboard --help
+```

package/docs/testing/genome-2.0-matrix.md

@@ -8,10 +8,10 @@
 | 2. Genome 2.0 is generated and saved | `aioson` core | Markdown and `.meta.json` are persisted together with v2 schema |
 | 3. New squad receives genome | `aioson` squad binding | Manifest, blueprint and readiness get synchronized bindings |
 | 4. Existing squad receives binding | `aioson` squad binding | Executor and squad scopes merge without breaking legacy executor genomes |
-| 5. Artisan generates Genome Brief | `aios-dashboard` Artisan API | Genome brief result returns markdown, confidence and fallback file write remains non-fatal |
-| 6. `/genomes` lists metadata | `aios-dashboard` catalog | Catalog returns local genome metadata, origin and binding counts |
-| 7. `/squads` shows bindings | `aios-dashboard` squads | Squad payload and UI consumers expose squad and executor bindings |
-| 8. `/pipelines` shows badges | `aios-dashboard` pipelines | Pipeline payload exposes contextual `genomeBindings` on squad nodes only |
+| 5. Artisan generates Genome Brief | `aioson-dashboard` Artisan API | Genome brief result returns markdown, confidence and fallback file write remains non-fatal |
+| 6. `/genomes` lists metadata | `aioson-dashboard` catalog | Catalog returns local genome metadata, origin and binding counts |
+| 7. `/squads` shows bindings | `aioson-dashboard` squads | Squad payload and UI consumers expose squad and executor bindings |
+| 8. `/pipelines` shows badges | `aioson-dashboard` pipelines | Pipeline payload exposes contextual `genomeBindings` on squad nodes only |
 | 9. Legacy data remains valid | cross-repo contract | Dashboard still reads manifests written by the core for legacy and v2 formats |
 
 ## Automated Coverage
@@ -24,7 +24,7 @@
 
 ## Rollout Entry Point
 
-- Full gated rollout: `npm run test:genome-2.0:rollout -- --dashboard-root ../aios-dashboard`
+- Full gated rollout: `npm run test:genome-2.0:rollout -- --dashboard-root ../aioson-dashboard`
 - Operational runbook: `genome-2.0-rollout.md`
 
 ## Shared Fixtures

package/docs/testing/genome-2.0-rollout.md

@@ -2,7 +2,7 @@
 
 ## Goal
 
-Bring the full Genome 2.0 package into `aioson` and `aios-dashboard` with explicit gates, repeatable checks, and a non-destructive fallback path.
+Bring the full Genome 2.0 package into `aioson` and `aioson-dashboard` with explicit gates, repeatable checks, and a non-destructive fallback path.
 
 This document operationalizes Phase 09 from `notes-local/plano-genome-2/09-rollout-checklist.md`.
 
@@ -18,10 +18,10 @@ This document operationalizes Phase 09 from `notes-local/plano-genome-2/09-rollo
 1. `aioson` Phase 01
 2. `aioson` Phase 02
 3. `aioson` Phase 03
-4. `aios-dashboard` Phase 04
-5. `aios-dashboard` Phase 05
-6. `aios-dashboard` Phase 06
-7. `aios-dashboard` Phase 07
+4. `aioson-dashboard` Phase 04
+5. `aioson-dashboard` Phase 05
+6. `aioson-dashboard` Phase 06
+7. `aioson-dashboard` Phase 07
 8. Integration coverage from Phase 08
 9. This rollout phase and final docs
 
@@ -44,7 +44,7 @@ This executes:
 
 ### Block B
 
-Run from `aios-dashboard`:
+Run from `aioson-dashboard`:
 
 ```bash
 npm run test:genome-2.0:block-b
@@ -58,7 +58,7 @@ This covers:
 
 ### Block C
 
-Run from `aios-dashboard`:
+Run from `aioson-dashboard`:
 
 ```bash
 npm run test:genome-2.0:block-c
@@ -72,7 +72,7 @@ This covers:
 
 ### Block D
 
-Run from `aios-dashboard`:
+Run from `aioson-dashboard`:
 
 ```bash
 npm run test:genome-2.0:block-d
@@ -89,7 +89,7 @@ This executes the full dashboard gate:
 Run from `aioson`:
 
 ```bash
-npm run test:genome-2.0:rollout -- --dashboard-root ../aios-dashboard
+npm run test:genome-2.0:rollout -- --dashboard-root ../aioson-dashboard
 ```
 
 Useful options:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaimevalasek/aioson",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "AI operating framework for hyper-personalized software.",
   "keywords": [
     "ai",
@@ -12,7 +12,7 @@
     "cli",
     "framework"
   ],
-  "license": "MIT",
+  "license": "AGPL-3.0-only",
   "main": "src/cli.js",
   "bin": {
     "aios": "bin/aioson.js",