raptor-aios 0.12.0 → 0.12.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +37 -0
- package/README.md +25 -6
- package/dist/_core/package.json +1 -1
- package/package.json +1 -1
- package/scripts/prepare-npm.mjs +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,43 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
|
|
|
5
5
|
|
|
6
6
|
## [Unreleased]
|
|
7
7
|
|
|
8
|
+
## [0.12.2] - 2026-06-16
|
|
9
|
+
|
|
10
|
+
### Changed
|
|
11
|
+
|
|
12
|
+
- **Glossário e README atualizados com os termos das releases 0.9.0→0.12.1.** O glossário
|
|
13
|
+
canônico (`docs/glossary.md`) ganhou 6 entradas novas — `gol-smiles (G1–G6)`, os Gol Gates
|
|
14
|
+
`gate.gol.*`, `deep_verify`, `Transport`, `Setup Wizard` e `Design / Figma Integration` — e
|
|
15
|
+
teve a contagem de gates atualizada (**48 gates**, família `gol` incluída; apêndices C/D
|
|
16
|
+
completados com `verify tangerina/arch/i18n`, `raptor setup` e `raptor design`). O README
|
|
17
|
+
passou a documentar a captura determinística do Figma (`figma-rest`), o preset `gol-smiles`
|
|
18
|
+
e atualizou o badge de versão. Certificação do glossário avançada para `0.12.1`.
|
|
19
|
+
|
|
20
|
+
### Fixed
|
|
21
|
+
|
|
22
|
+
- **Correção factual no glossário:** `gate.release.crash_free_window` não existe no código (é
|
|
23
|
+
apenas uma menção *future*) — removido do catálogo de gates.
|
|
24
|
+
|
|
25
|
+
## [0.12.1] - 2026-06-13
|
|
26
|
+
|
|
27
|
+
### Changed
|
|
28
|
+
|
|
29
|
+
- **Documentação em pt-BR.** Toda a documentação em `docs/` passa a ser escrita em
|
|
30
|
+
português brasileiro (identificadores técnicos — comandos `/raptor-*`, gates `gate.*`,
|
|
31
|
+
paths e campos de frontmatter — permanecem em inglês). Traduzidas e corrigidas contra o
|
|
32
|
+
código real: `artifact-chain.md` e `state-model.md` (comandos legados `/rpt.*` →
|
|
33
|
+
`/raptor-*`, criação de feature via `raptor new`, constituição em
|
|
34
|
+
`.raptor/constitution.md`) e `script-contract.md`.
|
|
35
|
+
- **`docs/spec-kit-parity.md` reescrita.** Comparação Raptor × Spec Kit confirmada por
|
|
36
|
+
análise de código: paridade 1:1 dos 9 comandos + a camada de enforcement (constituição
|
|
37
|
+
executável C1–C5/M1–M6, motor de 36+ gates, cadeia de staleness, verificação no edge) e
|
|
38
|
+
de captura (Jira/Figma determinísticos). Dados do Spec Kit atualizados a partir da fonte
|
|
39
|
+
oficial (comandos essenciais vs opcionais, 30+ agentes, tagline) e enriquecida com 5
|
|
40
|
+
diagramas mermaid. Escopo honesto: só `verify perf` roda o app; não há `verify crash`.
|
|
41
|
+
|
|
42
|
+
> Release só-docs: a pasta `docs/` não é empacotada no npm, então o pacote instalável é
|
|
43
|
+
> equivalente ao `0.12.0` (muda apenas o CHANGELOG e a versão).
|
|
44
|
+
|
|
8
45
|
## [0.12.0] - 2026-06-13
|
|
9
46
|
|
|
10
47
|
### Added
|
package/README.md
CHANGED
|
@@ -7,8 +7,8 @@
|
|
|
7
7
|
[](https://www.npmjs.com/package/raptor-aios)
|
|
8
8
|
[](https://nodejs.org)
|
|
9
9
|
[](https://reactnative.dev)
|
|
10
|
-
[](#️-desenvolvimento-local)
|
|
11
|
+
[](CHANGELOG.md)
|
|
12
12
|
[](LICENSE)
|
|
13
13
|
|
|
14
14
|
</div>
|
|
@@ -464,7 +464,7 @@ Declarar não é cumprir. O Raptor **mede** e compara com o declarado:
|
|
|
464
464
|
|
|
465
465
|
| Capacidade | Para que serve | Comandos |
|
|
466
466
|
| ----------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
|
|
467
|
-
| 🎚️ **Presets** | Conjuntos reusáveis de artigos + gates, empilháveis. Bundled: `mobile-opinionated
|
|
467
|
+
| 🎚️ **Presets** | Conjuntos reusáveis de artigos + gates, empilháveis. Bundled: `mobile-opinionated` (M1–M6), `gol-smiles` (G1–G6, empilha sobre mobile), `lean`. | `raptor preset list · add · info · remove` |
|
|
468
468
|
| 🔁 **Workflows** | Orquestram o ciclo via YAML, com gates de revisão humana. Bundled: `sdd-cycle`, `sdd-cycle-quick`. | `raptor workflow catalog · run · status · resume · list` |
|
|
469
469
|
| 🤖 **Agentes** | Materializa os slash commands por agente. | `raptor add-agent` · `raptor list-agents` |
|
|
470
470
|
| 🧠 **Skills** | Habilidades reusáveis materializadas para os agentes. | `raptor skill add · list · sync · remove` |
|
|
@@ -472,6 +472,7 @@ Declarar não é cumprir. O Raptor **mede** e compara com o declarado:
|
|
|
472
472
|
| 🪝 **Hooks** | Scripts disparados em **34 pontos** do ciclo (`before_*`/`after_*` de 17 comandos). | `raptor hook list · run` |
|
|
473
473
|
| 📦 **Extensões** | Pacotes self-contained (templates/gates/hooks/workflows). | `raptor extension add · list · info · remove` |
|
|
474
474
|
| 🎟️ **Jira** | Puxa issues do Jira (somente leitura) para semear specs. | `raptor jira connect · status · pull · disconnect` |
|
|
475
|
+
| 🎨 **Figma / Design** | Captura **determinística** de tokens/telas/assets/fontes do Figma (provider `figma-rest` + PAT) e semeia `design/`. | `raptor design connect · status · pull · sync · disconnect` |
|
|
475
476
|
| 📜 **Auditoria & trace** | Consulta a trilha de eventos e a rastreabilidade. | `raptor audit query · show` · `raptor trace` |
|
|
476
477
|
|
|
477
478
|
### 🎟️ Integração com Jira
|
|
@@ -484,6 +485,20 @@ raptor new login --jira APP-1234 # semeia a spec a partir da issue
|
|
|
484
485
|
|
|
485
486
|
> 📖 Como o card é capturado **por inteiro** (campos ricos, links de Figma) e redistribuído na spec — com os gates cobrando: veja [docs/jira-spec-enrichment.md](docs/jira-spec-enrichment.md).
|
|
486
487
|
|
|
488
|
+
### 🎨 Integração com Figma (design determinístico)
|
|
489
|
+
|
|
490
|
+
Em vez de o link do Figma virar só uma URL na spec, o Raptor **captura o design de forma determinística** e semeia a pasta `design/` — espelhando o modelo do Jira (Raptor captura, agente redistribui).
|
|
491
|
+
|
|
492
|
+
```bash
|
|
493
|
+
raptor design connect # provider figma-rest (Personal Access Token) — default, CI-friendly
|
|
494
|
+
raptor new home --figma <url-figma> # captura tokens/telas/assets/fontes e semeia design/
|
|
495
|
+
raptor design sync home # re-captura idempotente (nunca sobrescreve o refino)
|
|
496
|
+
```
|
|
497
|
+
|
|
498
|
+
O provider **`figma-rest`** usa a REST API da Figma com um PAT (`${FIGMA_TOKEN}` no `raptor.yml`), é determinístico e roda em CI. A captura gera `design/tokens.json` (colors/typography/spacing/radii), `design/screens/<slug>.md` (frames de topo) e `design/assets-manifest.json` (assets baixados com SHA-256, guarda anti-SSRF). Quando há captura real, os prompts fazem o **flip REDISTRIBUIR**: o agente passa a *refinar e redistribuir* os artefatos em disco em vez de "olhar o Figma" — cobrado pelo `gate.design.ready`.
|
|
499
|
+
|
|
500
|
+
> 📖 Detalhes, providers e limitações: [docs/design-figma-sync.md](docs/design-figma-sync.md) e [docs/design-gate.md](docs/design-gate.md).
|
|
501
|
+
|
|
487
502
|
---
|
|
488
503
|
|
|
489
504
|
## 📖 Referência de comandos CLI
|
|
@@ -493,11 +508,13 @@ raptor new login --jira APP-1234 # semeia a spec a partir da issue
|
|
|
493
508
|
🌿 Branch/commit commit · scan
|
|
494
509
|
🔬 Verificação verify · verify a11y · verify perf · verify stores · verify os-matrix
|
|
495
510
|
verify architecture · verify audit · verify constitution
|
|
511
|
+
verify tangerina · verify arch · verify i18n (preset gol-smiles)
|
|
496
512
|
📊 Status status · doctor · trace · audit query · audit show
|
|
497
513
|
⚖️ Governança gate list · gate approve · gate skip · repair constitution · hotfix · resync · upgrade
|
|
498
514
|
🧩 Extensão preset … · workflow … · skill … · mcp … · hook … · extension …
|
|
499
515
|
add-agent · list-agents · add-extension
|
|
500
516
|
🎟️ Jira jira connect · status · pull · disconnect
|
|
517
|
+
🎨 Figma/Design design connect · status · pull · sync · disconnect
|
|
501
518
|
```
|
|
502
519
|
|
|
503
520
|
Rode `raptor <comando> --help` para os detalhes (flags, exemplos) de cada um.
|
|
@@ -546,7 +563,7 @@ Flags disponíveis:
|
|
|
546
563
|
├── raptor.yml # ⚙️ config (preset, ai, git.branch_per_feature, commit_trailer)
|
|
547
564
|
├── raptor.manifest.json # 📋 manifest de instalação
|
|
548
565
|
├── agents.yml · skills.yml · mcp.yml
|
|
549
|
-
├── specs/<NNN-slug>/ # 📝 spec.md · plan.md · tasks.md · impl-log.md · audit.jsonl · checklists/
|
|
566
|
+
├── specs/<NNN-slug>/ # 📝 spec.md · plan.md · tasks.md · impl-log.md · audit.jsonl · checklists/ · design/ (tokens.json · screens/ · assets-manifest.json)
|
|
550
567
|
├── templates/ # 🧱 cópia bundlada (commands/*.md + *-template.md)
|
|
551
568
|
├── memory/ # 🧠 constitution copy · amendments.log · decisions.md · glossary.md
|
|
552
569
|
├── extensions/ · workflows/ · presets/ · hooks/ · scripts/ · cache/
|
|
@@ -564,8 +581,10 @@ Comece pelo **[📖 Glossário Canônico](docs/glossary.md)** — a referência
|
|
|
564
581
|
|
|
565
582
|
| Documento | Sobre |
|
|
566
583
|
| ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |
|
|
567
|
-
| **[📖 docs/glossary.md](docs/glossary.md)** | Glossário canônico: conceitos, hierarquias, catálogo de
|
|
584
|
+
| **[📖 docs/glossary.md](docs/glossary.md)** | Glossário canônico: conceitos, hierarquias, catálogo de 48 gates e de comandos CLI |
|
|
585
|
+
| [🧭 docs/setup-wizard.md](docs/setup-wizard.md) | Assistente de instalação `raptor setup`: onboarding, IA/IDE, preset, Jira/Figma |
|
|
568
586
|
| [🛡️ docs/readiness-gates.md](docs/readiness-gates.md) | Gates de prontidão (`spec/plan/tasks.ready`) em detalhe |
|
|
587
|
+
| [🎨 docs/design-figma-sync.md](docs/design-figma-sync.md) | Captura determinística do Figma (`figma-rest`): tokens/telas/assets/fontes + flip REDISTRIBUIR |
|
|
569
588
|
| [🎨 docs/design-gate.md](docs/design-gate.md) | Design gate, integração Figma e `assets-manifest.json` |
|
|
570
589
|
| [🔗 docs/artifact-chain.md](docs/artifact-chain.md) | Cadeia de artefatos e rastreabilidade spec→plan→tasks→código |
|
|
571
590
|
| [🎟️ docs/jira-spec-enrichment.md](docs/jira-spec-enrichment.md) | Enriquecimento de spec a partir de cards do Jira |
|
|
@@ -602,7 +621,7 @@ Monorepo pnpm (`packages/core` = `@raptor/core`, `packages/cli` = binário `rapt
|
|
|
602
621
|
```bash
|
|
603
622
|
pnpm install
|
|
604
623
|
pnpm build
|
|
605
|
-
pnpm -r test && pnpm test:e2e #
|
|
624
|
+
pnpm -r test && pnpm test:e2e # ~1356 testes (1071 core + ~251 cli + 34 e2e)
|
|
606
625
|
|
|
607
626
|
# usar a CLI local em outro projeto:
|
|
608
627
|
cd packages/cli && npm link # ou: pnpm link --global
|
package/dist/_core/package.json
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "raptor-aios",
|
|
3
|
-
"version": "0.12.
|
|
3
|
+
"version": "0.12.2",
|
|
4
4
|
"description": "Raptor — Spec-Driven Development (SDD) CLI for modern mobile apps. Constitutional gates, audit trail, real verification (a11y/perf/stores/OS matrix), and AI-agent slash commands.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
package/scripts/prepare-npm.mjs
CHANGED