@jaimevalasek/aioson 1.7.2 → 1.8.0

package/docs/en/schemas/parallel-status.schema.json

@@ -22,11 +22,12 @@
     "laneCount": { "type": "integer", "minimum": 1 },
     "statusCounts": {
       "type": "object",
-      "required": ["pending", "in_progress", "completed", "blocked", "other"],
+      "required": ["pending", "in_progress", "completed", "merged", "blocked", "other"],
       "properties": {
         "pending": { "type": "integer", "minimum": 0 },
         "in_progress": { "type": "integer", "minimum": 0 },
         "completed": { "type": "integer", "minimum": 0 },
+        "merged": { "type": "integer", "minimum": 0 },
         "blocked": { "type": "integer", "minimum": 0 },
         "other": { "type": "integer", "minimum": 0 }
       },
@@ -52,6 +53,84 @@
       },
       "additionalProperties": true
     },
+    "machineFiles": {
+      "type": "object",
+      "properties": {
+        "workspaceManifest": { "type": "boolean" },
+        "ownershipMap": { "type": "boolean" },
+        "mergePlan": { "type": "boolean" }
+      },
+      "additionalProperties": true
+    },
+    "ownership": {
+      "type": "object",
+      "properties": {
+        "assignedScopeCount": { "type": "integer", "minimum": 0 },
+        "conflictCount": { "type": "integer", "minimum": 0 },
+        "conflicts": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "scope_key": { "type": "string" },
+              "lanes": {
+                "type": "array",
+                "items": { "type": "integer", "minimum": 1 }
+              }
+            },
+            "additionalProperties": true
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "writeScope": {
+      "type": "object",
+      "properties": {
+        "laneCount": { "type": "integer", "minimum": 0 },
+        "totalPathCount": { "type": "integer", "minimum": 0 },
+        "uncoveredAssignedLaneCount": { "type": "integer", "minimum": 0 },
+        "invalidPatternCount": { "type": "integer", "minimum": 0 },
+        "conflictCount": { "type": "integer", "minimum": 0 }
+      },
+      "additionalProperties": true
+    },
+    "dependencies": {
+      "type": "object",
+      "properties": {
+        "declaredCount": { "type": "integer", "minimum": 0 },
+        "invalidCount": { "type": "integer", "minimum": 0 },
+        "blockedCount": { "type": "integer", "minimum": 0 },
+        "orderViolationCount": { "type": "integer", "minimum": 0 }
+      },
+      "additionalProperties": true
+    },
+    "merge": {
+      "type": "object",
+      "properties": {
+        "strategy": { "type": ["string", "null"] },
+        "order": {
+          "type": "array",
+          "items": { "type": "integer", "minimum": 1 }
+        },
+        "laneCount": { "type": "integer", "minimum": 0 },
+        "orderViolationCount": { "type": "integer", "minimum": 0 }
+      },
+      "additionalProperties": true
+    },
+    "sync": {
+      "type": "object",
+      "properties": {
+        "workspaceManifestInSync": { "type": "boolean" },
+        "ownershipMapInSync": { "type": "boolean" },
+        "mergePlanInSync": { "type": "boolean" },
+        "staleFiles": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": true
+    },
     "lanes": {
       "type": "array",
       "items": {
@@ -75,6 +154,17 @@
           "priority": { "type": "string" },
           "updatedAt": { "type": "string" },
           "scopeCount": { "type": "integer", "minimum": 0 },
+          "dependencyCount": { "type": "integer", "minimum": 0 },
+          "dependencies": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "mergeRank": { "type": "integer", "minimum": 1 },
+          "writePathCount": { "type": "integer", "minimum": 0 },
+          "writePaths": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
           "blockerCount": { "type": "integer", "minimum": 0 },
           "deliverables": {
             "type": "object",

package/docs/integrations/apps-publish-marketplace.md

@@ -0,0 +1,94 @@
+# `aioson system:publish` — Publicar apps no marketplace
+
+Como devs publicam apps via CLI no aioson.com para que clientes possam
+instalar via aioson-play.
+
+---
+
+## Comando
+
+```bash
+aioson system:publish [dir] [opções]
+```
+
+`[dir]` é o caminho da pasta do app (default: `.`). A pasta precisa ter
+`system.json` (manifesto) + `package.json` na raiz.
+
+### Opções
+
+| Flag | Efeito |
+|------|--------|
+| `--private` | Visibilidade privada (default é `public` → FREE no aioson-com) |
+| `--paid` | Marca como pago (requer plano Jedi) |
+| `--invite="email1,email2,..."` | Emails autorizados a instalar quando privado |
+| `--dry-run` | Valida e mostra o que seria enviado, sem publicar |
+
+### Emails autorizados (privates)
+
+Aceita 2 formas, com flag tendo precedência sobre o manifest:
+
+```bash
+aioson system:publish ./meu-app --private \
+  --invite="cliente1@empresa.com, cliente2@empresa.com"
+```
+
+Ou declarado no `system.json`:
+
+```json
+{
+  "slug": "meu-app",
+  "name": "Meu App",
+  "version": "1.0.0",
+  "authorized_emails": ["cliente1@empresa.com", "cliente2@empresa.com"]
+}
+```
+
+A lista é normalizada (lowercase, trim, dedup, validação básica de `@`).
+
+---
+
+## Fluxo no servidor
+
+`POST https://aioson.com/api/store/systems/publish` recebe:
+
+```json
+{
+  "kind": "aioson.store.system",
+  "slug": "meu-app",
+  "version": "1.0.0",
+  "files": { "system.json": "...", "package.json": "...", "src/...": "..." },
+  "manifest": { ... },
+  "visibility": "private",
+  "paid": false,
+  "authorizedEmails": ["cliente1@empresa.com"],
+  "workspaceSlug": null
+}
+```
+
+Server-side (`storePublishSystem` em `aioson-com/lib/store.ts`):
+1. Cria/atualiza `System` (visibility mapeada para enum: `private`→PRIVATE,
+   `public`→FREE, `paid`→PAID)
+2. Cria nova `SystemVersion` com `manifestJson` + `filesJson` + `packageHash`
+3. Quando privado: sincroniza tabela `SystemInvitee` (delete-then-insert)
+4. Retorna `{ ok, slug, version, packageHash, inviteeCount, quarantined }`
+
+---
+
+## Como o cliente instala
+
+Pelo aioson-play instalado:
+
+1. Login com email autorizado
+2. HomePage → Loja
+3. App aparece (filtrado por `getMarketplaceForUser`: visibilidade + invitee)
+4. Click no card → `POST /api/store/systems/install` → `storeInstallSystem`
+   valida visibilidade + invitee → devolve files+manifest
+5. Aioson-play extrai em `apps/{slug}/`
+
+---
+
+## Doc relacionada
+
+- `aioson-com/docs/apps-publish-install-spec.md` — spec consolidada do flow
+- `aioson-play/docs/aioson-app-developer-guide.md` §9 — visão do dev de app
+- `aioson-play/docs/dev-link-install.md` — alternativa pra dev (symlink)

package/docs/pt/README.md

@@ -12,6 +12,7 @@ Bem-vindo à documentação em português do AIOSON — um framework leve de age
 | [Deyvin](./deyvin.md) | Guia do agente de continuidade e pair programming do AIOSON |
 | [Cenários de Uso](./cenarios.md) | Exemplos completos e práticos para projetos MICRO, SMALL e MEDIUM |
 | [Guia de Agentes](./agentes.md) | Quando usar cada agente e o que ele entrega |
+| [Hardening do Motor](./motor-hardening.md) | Gates técnicos, auto-cura, test briefing e hardening autônomo do workflow |
 | [Squad e Genome](./squad-genome.md) | Como criar squads modulares, diferenciar skill de genome, aplicar genomes e publicar entregáveis HTML |
 | [Agentes Customizados](./agentes-customizados.md) | Criar agentes personalizados com `squad:agent-create` — tipos, Voice DNA, infra operacional, maturity scoring |
 | [Skills](./skills.md) | Sistema de skills: tipos, instalação, mapeamento por framework e compatibilidade cross-tool |
@@ -28,6 +29,14 @@ Bem-vindo à documentação em português do AIOSON — um framework leve de age
 | [Spec & Learnings Pipeline](./spec-learnings-pipeline.md) | Sincronizar specs Markdown com o SQLite, exportar learnings para brains e acompanhar progresso de features |
 | [Devlog Pipeline](./devlog-pipeline.md) | Processar devlogs manuais dos agentes, sincronizar artifacts/learnings/verdict com o SQLite e exportar para brains |
 | [Hooks & Session Guard](./hooks-session-guard.md) | Visibilidade automática no dashboard para Claude Code, Antigravity e Codex — instalar hooks, session:guard e diagnóstico |
+| [Governança de Design Docs](./design-docs-governance.md) | Sistema modular de regras duras de código que agentes aplicam automaticamente em toda sessão |
+| [Runner System](./runner-system.md) | Execução persistente em background: filas, daemon e planos por fase |
+| [Feature Archive](./feature-archive.md) | Arquivamento automático de artefatos de features concluídas e manifest de histórico |
+| [SDD Automation Scripts](./sdd-automation-scripts.md) | Scripts determinísticos da Regra dos 80%: preflight, gates, classificação e detecção de test runner |
+| [compress:agents](./compress-agents.md) | Reduzir consumo de tokens comprimindo instruções de agentes |
+| [Site Forge](./site-forge.md) | Clonar, reconstruir ou extrair design de qualquer URL |
+| [Profiler System](./profiler-system.md) | Pipeline completo de pesquisa, enriquecimento e forja de perfis cognitivos (Genome 3.0) |
+| [Genome 3.0 Spec](./genome-3.0-spec.md) | Especificação técnica do formato Genome 3.0 com campos DISC, Enneagram, Big Five e MBTI |
 
 ## Documentação em inglês
 

package/docs/pt/agentes.md

@@ -18,12 +18,30 @@ O AIOSON tem agentes oficiais de projeto e também pode criar agentes de squad.
 @ux-ui        ← UI/UX quando há interfaces (SMALL e MEDIUM)
 @pm           ← apenas MEDIUM
 @orchestrator ← apenas MEDIUM
+@pentester    ← revisao adversarial e seguranca antes do fechamento (MEDIUM)
 @dev          ← sempre o último antes do QA
 @qa           ← projetos SMALL e MEDIUM
+@tester       ← engenharia de testes e cobertura sistematica
 @squad        ← cria squads especializados no projeto
 @genome       ← cria genomes de domínio reutilizáveis
+
+# Agentes especializados (uso sob demanda)
+@committer          ← gera mensagens de commit semanticas
+@copywriter         ← copy para paginas e estrategia de conversao
+@cypher             ← transforma plans em briefings estruturados
+@design-hybrid-forge ← cria skills hibridas de design
+@discover           ← descobre o sistema e mapeia conhecimento
+@neo                ← guia de inicio, status e proximos passos
+@orache             ← pesquisa de mercado e competidores
+@profiler-researcher  ← pesquisa perfil/DNA mental
+@profiler-enricher    ← enriquece perfil cognitivo
+@profiler-forge       ← gera advisor da persona (genome 3.0)
+@site-forge          ← clona/rebuild de sites com skill
+@validator           ← valida entregaveis e contratos
 ```
 
+> **Nota sobre estrutura de arquivos (v1.7.3+):** Os manifests dos agentes (arquivos `.manifest.json`) foram movidos para `.aioson/agents/manifests/` para reduzir clutter no diretório de agentes. Os arquivos `.md` de instrução continuam em `.aioson/agents/`. Isso facilita a navegação e separa metadados de prompts.
+
 > Para o fluxo completo de `@squad` e `@genome`, veja também [Squad e Genome](./squad-genome.md).
 > Para criar agentes customizados (my-agents e squad agents), veja [Agentes Customizados](./agentes-customizados.md).
 > Para uma explicação focada no agente de continuidade, veja também [Deyvin](./deyvin.md).
@@ -301,7 +319,7 @@ tests/
 
 ---
 
-## UI/UX (`@ux-ui`)
+## @ux-ui
 
 **Quando usar:** Quando o projeto tem interfaces (web apps, landing pages com formulários). SMALL e MEDIUM.
 
@@ -555,6 +573,23 @@ Se o usuário pedir para pular o teste, o `@dev` resiste, explica, e só cede ap
 - Testes para achados críticos
 - Relatório de cobertura
 
+**Fechamento de feature (automático):**
+
+Quando o QA é aprovado, o `@qa` roda:
+
+```bash
+aioson feature:close . --feature={slug} --verdict=PASS --residual="..."
+```
+
+Isso faz tudo de uma vez — sem etapas manuais:
+1. Adiciona QA sign-off em `spec-{slug}.md`
+2. Marca a feature como `done` em `features.md`
+3. Limpa `project-pulse.md`
+4. Move todos os artefatos da feature (`prd-`, `spec-`, `requirements-`, etc.) para `.aioson/context/done/{slug}/`
+5. Atualiza `.aioson/context/done/MANIFEST.md`
+
+O root de `.aioson/context/` fica limpo automaticamente. O desenvolvedor não precisa rodar nenhum comando adicional.
+
 > **@qa vs @tester** — O `@qa` é um revisor: lê o que foi implementado, aponta riscos e escreve testes pontuais para achados críticos. O `@tester` é um engenheiro de testes: parte de cobertura zero e constrói uma estratégia sistemática (inventário, mapa de risco, estratégia por camada). Use `@tester` quando a aplicação foi implementada sem testes adequados ou quando `@qa` identificar lacunas em 3+ módulos.
 
 ---
@@ -639,6 +674,290 @@ Se o usuário pedir para pular o teste, o `@dev` resiste, explica, e só cede ap
 
 ---
 
+---
+
+## Agentes especializados e auxiliares
+
+Agentes que nao fazem parte do fluxo principal de entrega, mas entram sob demanda para tarefas especificas.
+
+---
+
+## @committer
+
+**Quando usar:** Quando voce quer gerar mensagens de commit semanticas ou preparar um conjunto de mudancas para o Git.
+
+**O que faz:**
+- Le o diff staged (ou working tree) e gera mensagem de commit no formato convencional
+- Pode gerar `commit-prep.json` com lista de arquivos, tipo de mudanca e descricao
+- Respeita o escopo do projeto e o formato definido no `spec.md`
+
+**Como ativar:**
+```
+@committer
+```
+
+**Entrega:**
+- Mensagem de commit pronta para copiar ou mensagem semantica no formato `tipo(escopo): descricao`
+- Opcionalmente `.aioson/context/commit-prep.json`
+
+---
+
+## @copywriter
+
+**Quando usar:** Quando voce precisa de copy para landing pages, emails, CTAs ou qualquer texto voltado a conversao.
+
+**O que faz:**
+- Escreve copy com foco em conversao e clareza
+- Pode seguir uma voz de marca definida no PRD ou no `design-doc.md`
+- Gera variantes de headline, descricao e CTA
+- Nao substitui um redator humano, mas acelera a primeira versao
+
+**Como ativar:**
+```
+@copywriter
+```
+
+**Entrega:**
+- Textos prontos para uso em interfaces, landing pages ou campanhas
+
+---
+
+## @cypher
+
+**Quando usar:** Quando voce tem notas, rascunhos ou plans brutos em `plans/` e quer transforma-los em um briefing estruturado antes de iniciar o fluxo de produto.
+
+**O que faz:**
+- Le arquivos de `plans/` e sintetiza um briefing enriquecido
+- Identifica gaps, riscos e perguntas em aberto
+- Faz web research para validar suposicoes tecnicas ou de mercado
+- Produz `.aioson/briefings/{slug}/briefings.md`
+- Nao cria PRD — isso e responsabilidade do @product
+
+**Como ativar:**
+```
+@cypher
+```
+
+**Entrega:**
+- `.aioson/briefings/{slug}/briefings.md` com contexto, problema, solucao proposta, riscos, gaps e open questions
+- `.aioson/briefings/config.md` — registro de todos os briefings
+
+---
+
+## @design-hybrid-forge
+
+**Quando usar:** Quando voce quer criar uma skill de design hibrida combinando duas skills primarias ja existentes.
+
+**O que faz:**
+- Recebe duas skills de design (ex: `frontend-design` + `interface-design`)
+- Analisa os principios, tokens e decisoes de cada uma
+- Gera uma skill hibrida com contrato unico, nome, descricao e referencias
+- Salva em `.aioson/installed-skills/{hybrid-name}/`
+
+**Como ativar:**
+```
+@design-hybrid-forge
+```
+
+**Entrega:**
+- Skill hibrida completa em `.aioson/installed-skills/{slug}/SKILL.md`
+
+---
+
+## @discover
+
+**Quando usar:** Quando voce quer mapear um projeto existente (brownfield) antes de comecar a trabalhar nele, ou quando quer atualizar a memoria do sistema.
+
+**O que faz:**
+- Escaneia a estrutura de pastas e arquivos do projeto
+- Gera indices e mapas semanticos (`scan-index.md`, `scan-folders.md`)
+- Pode gerar ou atualizar `discovery.md` e `skeleton-system.md`
+- Constroi um cache de conhecimento que outros agentes consomem
+
+**Como ativar:**
+```
+@discover
+```
+
+**Ou via CLI:**
+```bash
+npx @jaimevalasek/aioson scan:project . --folder=src
+```
+
+**Entrega:**
+- `scan-index.md`, `scan-folders.md`, `scan-<pasta>.md`, `scan-aioson.md`
+- `memory-index.md`, `module-<pasta>.md`
+- Com `--with-llm`: `discovery.md` e `skeleton-system.md`
+
+---
+
+## @neo
+
+**Quando usar:** Quando voce esta perdido, quer entender o status atual do projeto ou nao sabe qual agente ativar em seguida.
+
+**O que faz:**
+- Le `project-pulse.md`, `features.md`, `spec.md` e `workflow.state.json`
+- Resume o estado atual do projeto em poucas linhas
+- Sugere o proximo agente ou acao com base no estado do workflow
+- Responde perguntas do tipo "por onde comeco?" e "o que falta fazer?"
+
+**Como ativar:**
+```
+@neo
+```
+
+**Entrega:**
+- Resumo do status do projeto
+- Recomendacao do proximo passo
+
+---
+
+## @orache
+
+**Quando usar:** Quando voce precisa de pesquisa de mercado, analise competitiva ou investigacao de dominio antes de definir o escopo do produto.
+
+**O que faz:**
+- Pesquisa na web sobre mercado, concorrentes e tendencias
+- Valida suposicoes de produto com dados externos
+- Gera resumos estruturados salvos em `researchs/{slug}/summary.md`
+- Segue o protocolo de cache de pesquisa: verifica `researchs/` antes de buscar novamente
+
+**Como ativar:**
+```
+@orache
+```
+
+**Entrega:**
+- `researchs/{slug}/summary.md` com frontmatter (searched_at, agent, query, verdict) + findings
+- `researchs/{slug}/files/` com conteudo raw das fontes consultadas
+
+---
+
+## @pentester
+
+**Quando usar:** Antes do fechamento de uma feature (especialmente MEDIUM), quando voce quer uma revisao adversarial focada em seguranca.
+
+**O que faz:**
+- Atua com mentalidade de atacante, nao de validador
+- Revisa superficies de ataque: memory context, tool invocation, auth, handoff, protocol contracts, secrets, runtime permissions
+- Gera findings estruturados em `.aioson/context/security-findings-{slug}.json`
+- So opera em ambiente local/controlado — nunca em producao ou internet publica
+- Findings `high`/`critical` podem bloquear o Gate D no @qa
+
+**Como ativar:**
+```
+@pentester
+```
+
+**Entrega:**
+- `.aioson/context/security-findings-{slug}.json` com review_contract, threat_surfaces e findings priorizados
+
+> **Importante:** O `@pentester` nao corrige vulnerabilidades — ele apenas encontra e documenta. A correcao e feita pelo `@dev` e a aprovacao pelo `@qa`.
+
+---
+
+## @profiler-researcher
+
+**Quando usar:** Quando voce quer pesquisar o "DNA mental" de uma pessoa — perfil cognitivo, comportamental e de comunicacao.
+
+**O que faz:**
+- Pesquisa na web e em fontes disponiveis sobre a pessoa-alvo
+- Gera um perfil inicial com dimensoes cognitivas e comportamentais
+- Salva o resultado para enriquecimento posterior
+
+**Como ativar:**
+```
+@profiler-researcher
+```
+
+**Entrega:**
+- Perfil inicial da persona em formato estruturado
+
+---
+
+## @profiler-enricher
+
+**Quando usar:** Quando voce ja tem um perfil inicial e quer aprofundar a analise cognitiva.
+
+**O que faz:**
+- Le o perfil gerado pelo `@profiler-researcher`
+- Analisa padroes de cognicao, comunicacao e decisao
+- Enriquece o perfil com insights mais profundos
+
+**Como ativar:**
+```
+@profiler-enricher
+```
+
+**Entrega:**
+- Perfil cognitivo enriquecido
+
+---
+
+## @profiler-forge
+
+**Quando usar:** Quando voce quer transformar um perfil enriquecido em um advisor funcional (genome 3.0) que pode ser usado por squads ou agentes.
+
+**O que faz:**
+- Le o perfil enriquecido
+- Gera um advisor com voice DNA, principios de decisao e framework operacional
+- Materializa o genome em um artefato reutilizavel
+
+**Como ativar:**
+```
+@profiler-forge
+```
+
+**Entrega:**
+- Advisor/Gerome 3.0 da persona
+
+---
+
+## @site-forge
+
+**Quando usar:** Quando voce quer clonar o design de um site existente ou reconstruir uma URL usando uma skill de design especifica.
+
+**O que faz:**
+- Recebe uma URL e uma skill de design (ou extrai a skill do proprio site)
+- Gera a estrutura, componentes e estilos necessarios
+- Pode produzir entregaveis HTML/CSS/JS ou integrar com o framework do projeto
+
+**Como ativar:**
+```
+@site-forge
+```
+
+**Exemplos de uso:**
+```
+Clone este site com a skill premium-command-center-ui
+Reconstrua https://exemplo.com usando a skill clean-saas-ui
+Extraia o design de https://exemplo.com como uma skill
+```
+
+**Entrega:**
+- Codigo e/ou skill extraida do site alvo
+
+---
+
+## @validator
+
+**Quando usar:** Quando voce quer validar entregaveis, contratos ou checklists antes de aprovar uma etapa.
+
+**O que faz:**
+- Valida se artefatos cumprem criterios definidos
+- Pode verificar conformidade com schemas, contratos ou regras de negocio
+- Funciona como uma camada adicional de verificacao antes de gates
+
+**Como ativar:**
+```
+@validator
+```
+
+**Entrega:**
+- Relatorio de validacao com pass/fail por criterio
+
+---
+
 ## Resumo: fluxo por tamanho
 
 ### MICRO
@@ -655,9 +974,11 @@ Duração típica: horas a dias. Análise leve, estrutura clara.
 
 ### MEDIUM
 ```
-@setup → @product → [@sheldon] → @analyst → @architect → @ux-ui → @pm → @orchestrator → @dev → @qa → [@tester]
+@setup → @product → [@sheldon] → @analyst → @architect → @ux-ui → @pm → @orchestrator → @dev → @pentester → @qa → [@tester]
 ```
-Duração típica: dias a semanas. Análise completa, paralelismo, backlog formal.
+Duração típica: dias a semanas. Análise completa, paralelismo, backlog formal, revisao adversarial obrigatoria.
+
+> O `@pentester` entra obrigatoriamente em projetos MEDIUM entre `@dev` e `@qa`. Em projetos sensiveis ou com requisitos de seguranca, ative-o tambem em SMALL.
 
 `[@sheldon]` — opcional, recomendado antes de iniciar a cadeia de execução para validar o PRD.
 `[@tester]` — opcional, recomendado quando a cobertura de testes for insuficiente após `@dev`.

package/docs/pt/clientes-ai.md

@@ -232,12 +232,16 @@ Alias compativel:
 
 ### Estrutura dos comandos Gemini
 
-Cada arquivo `.gemini/commands/aios-*.toml` aponta para o agente correspondente:
+Cada arquivo `.gemini/commands/aios-*.toml` aponta para o agente correspondente usando o campo `prompt` e injeção de arquivo:
 
 ```toml
-name = "aios-setup"
 description = "Project onboarding"
-instruction_file = ".aioson/agents/setup.md"
+prompt = """
+@{ .aioson/context/project.context.md }
+@{ .aioson/agents/setup.md }
+
+{{args}}
+"""
 ```
 
 ---