> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiparlance.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Emitter de workers

> @aiparlance/workers — papel workers, nota 4/20, objetivos pass/partial/fail

# Emitter de workers

|                     |                                                                                                                                           |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Pacote              | `@aiparlance/workers`                                                                                                                     |
| CLI                 | `aip emit workers`                                                                                                                        |
| Papel               | `workers`                                                                                                                                 |
| **Nota**            | **4/20** (20%)                                                                                                                            |
| Nível               | Stub em prévia                                                                                                                            |
| Ficha de maturidade | [transpilers/workers/EMITTER\_OBJECTIVES.md](https://github.com/eudameron/aiparlance/blob/main/transpilers/workers/EMITTER_OBJECTIVES.md) |

Avaliado pelo checklist mestre ([55 IDs](https://github.com/eudameron/aiparlance/blob/main/EMITTER_OBJECTIVES.md), v2 · 2026-08-06).

## Resumo

| ✅ Passou | ⚠️ Parcial | ❌ Falhou | ➖ N/A |
| -------- | ---------- | -------- | ----- |
| 4        | 3          | 13       | 35    |

Itens N/A estão fora do papel `workers` e não entram no denominador da nota.

## O que produz

Stubs TS de job/fila + arestas `dispatches` dos workflows.

## ✅ Passou

| ID   | Objetivo                                                                      |
| ---- | ----------------------------------------------------------------------------- |
| `G2` | Emitir declarações / bindings de `queue`                                      |
| `H3` | Golden / CI para `minimal.aip` (ou equivalente no alvo)                       |
| `H4` | O emit funciona nos examples full-tier correspondentes sem crash              |
| `H5` | Nomenclatura alinhada à documentação (tabelas no plural, `*_id`, snake\_case) |

## ⚠️ Parcial

| ID   | Objetivo                                                 |
| ---- | -------------------------------------------------------- |
| `F2` | Handlers/jobs fazem trabalho real (não só 501 / `throw`) |
| `G1` | Emitir artefatos `job` (chamáveis ou agendáveis)         |
| `G3` | Conectar `dispatch` do workflow                          |

## ❌ Ainda falhando (aplicáveis)

| ID   | Objetivo                                                   |
| ---- | ---------------------------------------------------------- |
| `F1` | Ponto de entrada executável (servidor ou worker)           |
| `F3` | Leitura/escrita em DB (ou query gerada / camada ORM)       |
| `F4` | Validação de request em runtime alinhada com B\*           |
| `F5` | Checagens de policy em runtime alinhadas com E\*           |
| `G4` | Conectar `notify` do workflow                              |
| `G5` | Conectar `emit` do workflow + tipos `event`                |
| `G6` | Conectar hooks de `lifecycle` (`on` / `before` / `after`)  |
| `G7` | Expor `ai_context` (emit, embed ou artefato para agentes)  |
| `H1` | Documentação legível de API / domínio                      |
| `H2` | Fixtures ou scaffolds de testes automatizados              |
| `J1` | Config/env para DB URL e secrets (sem hardcoding)          |
| `J2` | Observabilidade mínima (request id e/ou logs estruturados) |
| `J3` | Endpoint de health/readiness ou hook de liveness do worker |

Ficha de maturidade completa (incluindo ➖ N/A): [transpilers/workers/EMITTER\_OBJECTIVES.md](https://github.com/eudameron/aiparlance/blob/main/transpilers/workers/EMITTER_OBJECTIVES.md).

## Testes

Fixture vs `ops-reference.aip`; testes do pacote.

```bash theme={null}
npm test
node packages/cli/dist/cli.js emit workers examples/ops-reference.aip
```

## Relacionado

* [Visão geral dos emitters](/pt/emitters)
* [EMITTER\_OBJECTIVES mestre](https://github.com/eudameron/aiparlance/blob/main/EMITTER_OBJECTIVES.md)
* [Primeiros emitters](/pt/first-transpiler)
* [Comece aqui](/pt/getting-started)