@jaimevalasek/aioson 1.3.0 → 1.4.0

package/docs/pt/profiler-system.md

@@ -1,6 +1,6 @@
 # Sistema Profiler — Guia Rápido
 
-> Pipeline oficial para pesquisa, enriquecimento e geração de Genoma 3.0 e Advisors no AIOSON.
+> Pipeline oficial para pesquisa, enriquecimento e geração de Genome 3.0 e Advisors no AIOSON.
 
 ---
 
@@ -16,7 +16,7 @@ O Sistema Profiler cria um perfil cognitivo inferido de pessoas públicas a part
 
 O pipeline gera dois outputs principais:
 
-- `Genoma 3.0`: conhecimento destilado + perfil cognitivo aplicável a agentes executores
+- `Genome 3.0`: conhecimento destilado + perfil cognitivo aplicável a agentes executores
 - `Advisor Agent`: conselheiro ativo que responde como a persona, com web search e memória
 
 ---
@@ -30,7 +30,7 @@ O fluxo oficial é sequencial:
 2. `@profiler-enricher`
    Consolida a pesquisa com materiais extras do usuário e produz `.aioson/profiler-reports/{person-slug}/enriched-profile.md`
 3. `@profiler-forge`
-   Transforma o perfil enriquecido em Genoma 3.0, Advisor Agent ou ambos
+   Transforma o perfil enriquecido em Genome 3.0, Advisor Agent ou ambos
 
 Fluxo resumido:
 
@@ -41,7 +41,7 @@ Pessoa alvo
   -> @profiler-enricher
   -> enriched-profile.md
   -> @profiler-forge
-  -> Genoma 3.0 / Advisor / ambos
+  -> Genome 3.0 / Advisor / ambos
 ```
 
 ---
@@ -61,20 +61,20 @@ Depois siga a sequência natural:
 @profiler-forge stefan-georgi
 ```
 
-### Opção 2: via `@genoma`
+### Opção 2: via `@genome`
 
 ```text
-@genoma
+@genome
 Tipo: persona
 Pessoa: Stefan Georgi
 Domínio: direct response copywriting
 ```
 
-Quando `type: persona` é detectado, o `@genoma` deve redirecionar para o pipeline profiler por padrão.
+Quando `type: persona` é detectado, o `@genome` deve redirecionar para o pipeline profiler por padrão.
 
 ### Opção 3: modo rápido
 
-Se o usuário pedir explicitamente um genoma persona rápido, leve ou `--quick`, o sistema pode gerar um resultado com baixa fidelidade usando apenas conhecimento inferido do LLM.
+Se o usuário pedir explicitamente um genome persona rápido, leve ou `--quick`, o sistema pode gerar um resultado com baixa fidelidade usando apenas conhecimento inferido do LLM.
 
 Nesses casos:
 
@@ -120,16 +120,16 @@ Todos os perfis psicométricos devem ser tratados como `INFERIDOS`.
 ### Outputs finais
 
 ```text
-.aioson/genomas/{person-slug}-{domain-slug}.md
-.aioson/genomas/{person-slug}-{domain-slug}.meta.json
+.aioson/genomes/{person-slug}-{domain-slug}.md
+.aioson/genomes/{person-slug}-{domain-slug}.meta.json
 .aioson/advisors/{person-slug}-advisor.md
 ```
 
 ---
 
-## Quando usar Genoma 3.0
+## Quando usar Genome 3.0
 
-Use Genoma 3.0 quando você quer enriquecer executores já existentes com a forma de pensar de uma pessoa.
+Use Genome 3.0 quando você quer enriquecer executores já existentes com a forma de pensar de uma pessoa.
 
 Exemplos:
 
@@ -137,7 +137,7 @@ Exemplos:
 - estrategista editorial operando com lentes mentais de um criador específico
 - time de liderança avaliando decisões com a filosofia operacional de uma referência
 
-Genoma é artefato passivo. Ele não executa sozinho.
+Genome é artefato passivo. Ele não executa sozinho.
 
 ---
 
@@ -196,10 +196,10 @@ Sinais de profiling fraco:
 
 ## Relação com o sistema atual
 
-O Profiler System é uma extensão do fluxo de genomas, não um substituto do Genoma 2.0.
+O Profiler System é uma extensão do fluxo de genomes, não um substituto do Genome 2.0.
 
-- Genoma 2.0 continua válido para `domain` e `function`
-- Genoma 3.0 entra quando existe `persona`
+- Genome 2.0 continua válido para `domain` e `function`
+- Genome 3.0 entra quando existe `persona`
 - Advisors convivem com squads como membros consultivos
 - relatórios intermediários viram a fonte de verdade para reprocessamento futuro
 
@@ -211,4 +211,4 @@ O Profiler System é uma extensão do fluxo de genomas, não um substituto do Ge
 - não omitir limitações do perfil
 - não pular o enriquecimento quando o objetivo for alta fidelidade
 - preservar os relatórios intermediários como trilha de auditoria
-- preferir `Genoma 3.0 + Advisor` quando o caso exigir execução e consultoria
+- preferir `Genome 3.0 + Advisor` quando o caso exigir execução e consultoria

package/docs/pt/runtime-observability.md

@@ -60,7 +60,11 @@ O gateway oficial de execucao deve:
 - `install` e `init` agora inicializam o runtime no projeto
 - `execution_events` foi adicionado ao schema do runtime
 - `workflow:next` sincroniza task/run/eventos reais no SQLite via gateway
-- `agent:prompt` classifica handoffs diretos de `@squad` e `@orchestrator` no runtime
+- `agent:prompt` classifica handoffs diretos de agentes oficiais e cria a task/run inicial no runtime
+- `runtime:session:start|log|finish|status` oferece uma camada direta para manter sessoes de agentes oficiais abertas e visiveis no dashboard durante o trabalho iterativo
+- `live:start|handoff|status|close` e `runtime:emit` formam o launcher/supervisor oficial para clientes externos, mantendo uma `session_key` viva, trocando `active_agent` por handoff e persistindo estado compacto no SQLite com historico verbose em `.aioson/runtime/live/{session_key}/`
+- `runtime:status --json` agora expoe projecoes prontas para dashboard e scripts: `activeLiveSessions`, `activeMicroTasks`, `recentLiveSessions`, `recentMicroTasks` e `recentHandoffs`
+- ativacao por linguagem natural direto no cliente (ex.: mencionar `@deyvin` no Codex) ainda nao passa pelo gateway e, portanto, nao garante registros em `tasks` e `agent_runs`
 - `parallel:init`, `parallel:assign` e `parallel:status` registram operacoes canonicas de orquestracao
 - templates novos nao instruem mais o agente a chamar `runtime-log` por shell snippet
 

package/docs/pt/skills.md

@@ -0,0 +1,175 @@
+# Sistema de Skills do AIOSON
+
+O AIOSON possui um sistema de skills que fornece convenções, padrões e referências específicas por framework, design system ou domínio técnico. As skills são carregadas sob demanda pelos agentes conforme o contexto do projeto.
+
+## Tipos de skills
+
+### Skills gerenciadas (`.aioson/skills/`)
+
+Distribuídas automaticamente pelo CLI durante `aioson init` ou `aioson update`. São **gitignored** — não versionadas com o projeto, pois o CLI as mantém atualizadas.
+
+Estrutura:
+
+```
+.aioson/skills/
+├── static/          ← convenções e padrões por framework
+│   ├── laravel-conventions.md
+│   ├── tall-stack-patterns.md
+│   ├── jetstream-setup.md
+│   ├── filament-patterns.md
+│   ├── flux-ui-components.md
+│   ├── django-patterns.md
+│   ├── fastapi-patterns.md
+│   ├── rails-conventions.md
+│   ├── nextjs-patterns.md
+│   ├── react-motion-patterns.md
+│   ├── node-express-patterns.md
+│   ├── node-typescript-patterns.md
+│   ├── web3-ethereum-patterns.md
+│   ├── web3-solana-patterns.md
+│   ├── web3-cardano-patterns.md
+│   └── web3-security-checklist.md
+├── dynamic/         ← referências consultadas via web quando necessário
+│   ├── laravel-docs.md
+│   ├── flux-ui-docs.md
+│   ├── npm-packages.md
+│   ├── ethereum-docs.md
+│   ├── solana-docs.md
+│   └── cardano-docs.md
+└── design/          ← design systems visuais
+    ├── cognitive-core-ui/
+    ├── interface-design/
+    └── premium-command-center-ui/
+```
+
+**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.
+
+### 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.
+
+Cada skill instalada contém um `SKILL.md` com frontmatter YAML descrevendo quando usá-la.
+
+## Instalando skills
+
+### Via npm (pacotes públicos)
+
+```bash
+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/`)
+4. Registra a skill na seção "Installed skills" do `AGENTS.md`
+
+### Via aioson.com (registry cloud)
+
+```bash
+aioson skill:install cloud:nome-da-skill
+```
+
+Requer autenticação com `aioson auth:login`. Busca skills publicadas no marketplace do aioson.com.
+
+### Via arquivo local
+
+```bash
+aioson skill:install ./caminho/para/skill/
+```
+
+Copia o diretório da skill diretamente para `.aioson/installed-skills/`.
+
+## Gerenciando skills
+
+### Listar skills instaladas
+
+```bash
+aioson skill:list
+```
+
+Mostra todas as skills em `.aioson/installed-skills/` com nome, descrição e fonte.
+
+### Remover uma skill
+
+```bash
+aioson skill:remove nome-da-skill
+```
+
+Remove de `.aioson/installed-skills/` e de todos os diretórios de ferramentas (`.claude/skills/`, `.cursor/skills/`, `.windsurf/skills/`).
+
+## Compatibilidade com ferramentas
+
+As skills instaladas são distribuídas automaticamente para as ferramentas de IA suportadas:
+
+| Ferramenta | Diretório | Como acessa |
+|------------|-----------|-------------|
+| Claude Code | `.claude/skills/` | Acesso direto por path |
+| Cursor | `.cursor/skills/` | Acesso direto por path |
+| Windsurf | `.windsurf/skills/` | Acesso direto por path |
+| Codex | `AGENTS.md` | Via referência `@slug` no arquivo AGENTS.md |
+| Gemini CLI | `.aioson/installed-skills/` | Acesso direto por path |
+
+### Nota sobre gitignore
+
+Mesmo que `.aioson/skills/` esteja no gitignore, todas as ferramentas (Claude Code, Gemini CLI, Codex) conseguem ler os arquivos via path direto no filesystem. O gitignore afeta apenas a descoberta automática do Codex via `@` — mas como as skills são referenciadas por path explícito nos agentes, isso não é um problema.
+
+## Mapeamento framework → skill
+
+O agente `@dev` usa o valor de `framework` do `project.context.md` para decidir quais skills carregar:
+
+| Framework | Skill estática | Referência dinâmica |
+|-----------|---------------|---------------------|
+| Laravel | `laravel-conventions.md` | `laravel-docs.md` |
+| Laravel + TALL | + `tall-stack-patterns.md` | |
+| Laravel + Jetstream | + `jetstream-setup.md` | |
+| Laravel + Filament | + `filament-patterns.md` | |
+| Laravel + Flux UI | + `flux-ui-components.md` | `flux-ui-docs.md` |
+| Django | `django-patterns.md` | |
+| FastAPI | `fastapi-patterns.md` | |
+| Rails | `rails-conventions.md` | |
+| Next.js | `nextjs-patterns.md` | `npm-packages.md` |
+| React | `react-motion-patterns.md` | `npm-packages.md` |
+| Express / Fastify | `node-express-patterns.md` | `npm-packages.md` |
+| Node.js + TypeScript | `node-typescript-patterns.md` | `npm-packages.md` |
+
+Para projetos Web3, skills adicionais são carregadas conforme `web3_networks`:
+
+| Rede | Skill estática | Referência dinâmica |
+|------|---------------|---------------------|
+| Ethereum | `web3-ethereum-patterns.md` | `ethereum-docs.md` |
+| Solana | `web3-solana-patterns.md` | `solana-docs.md` |
+| Cardano | `web3-cardano-patterns.md` | `cardano-docs.md` |
+
+## Skills de design
+
+Skills de design são especiais — apenas **uma** pode estar ativa por projeto, definida pelo campo `design_skill` em `project.context.md`. O agente `@dev` aplica exclusivamente o design system selecionado, sem misturar padrões de outros sistemas.
+
+Skills de design disponíveis:
+- `cognitive-core-ui` — UI com foco cognitivo
+- `interface-design` — Design de interfaces (dashboards, apps, ferramentas)
+- `premium-command-center-ui` — UI premium para command centers
+
+## 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.
+
+## Criando skills
+
+Uma skill é um diretório com pelo menos um arquivo `SKILL.md` contendo:
+
+```markdown
+---
+name: nome-da-skill
+description: Descrição curta do que a skill faz
+triggers:
+  - quando usar esta skill
+  - outro cenário de uso
+---
+
+# Nome da Skill
+
+Conteúdo da skill com convenções, padrões, exemplos de código, etc.
+```
+
+O frontmatter `description` e `triggers` são usados pelos agentes para decidir se devem carregar a skill para a tarefa atual.