raptor-aios 0.12.1 → 0.13.0

package/CHANGELOG.md

@@ -5,6 +5,56 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [0.13.0] - 2026-06-18
+
+### Fixed
+
+- **`raptor new` parou de "sobrescrever" specs anteriores — resolução de feature por slug
+  exato.** `featureDir()`/`auditableDir()` casavam o slug informado por **sufixo**
+  (`d.endsWith('-'+slug)`) e devolviam o primeiro match, então um slug curto resolvia
+  silenciosamente para um diretório irmão mais longo (`home-screen` →
+  `001-dashboard-home-screen`). Os ~22 comandos a jusante (`plan`, `tasks`, `implement`,
+  `clarify`, `verify`, `status`, `audit`, …) passavam a operar sobre a feature **errada**,
+  parecendo sobrescrever os artefatos da anterior. Agora o match é **exato** (nome completo
+  `NNN-slug` ou slug após o número); múltiplos diretórios casando viram **erro de
+  ambiguidade** em vez de adivinhação.
+- **`raptor new` não quebra mais quando `.raptor/specs` não existe.** Git não versiona
+  diretórios vazios, então um clone novo (ou após `git clean`) podia não ter a pasta; o
+  `readdir` agora tolera a ausência e trata como "sem features".
+
+### Changed
+
+- **Branches de feature passam a empilhar (forkam do HEAD atual, não mais de `main`).** Com
+  `git.branch_per_feature`, cada feature nascia de uma `main` sem as specs das irmãs
+  (commitadas só nas branches delas); ao trocar de branch o Git esvaziava a pasta da spec
+  anterior (deixando só a casca `contracts/`), dando a impressão de perda de artefatos. Agora
+  a branch nova forka da **branch ativa**, então as specs anteriores são herdadas no working
+  tree e o histórico empilha. A primeira feature ainda nasce de `main` naturalmente (é onde
+  você começa); HEAD destacado cai no fallback da branch-base.
+- **Numeração `NNN` à prova de colisão entre branches.** O próximo número agora vem da
+  **união** das pastas em `.raptor/specs/` **e** dos números embutidos nos nomes de **todas
+  as branches** (locais e remotas, via novo `listBranches()` do core), eliminando o
+  `feat/002-*` duplicado que surgia quando o contador só via a árvore da branch atual. O
+  reuso-por-slug também consulta as branches, preservando a idempotência de `raptor new`
+  (re-rodar um slug que vive só em uma branch irmã volta para o número dela).
+
+## [0.12.2] - 2026-06-16
+
+### Changed
+
+- **Glossário e README atualizados com os termos das releases 0.9.0→0.12.1.** O glossário
+  canônico (`docs/glossary.md`) ganhou 6 entradas novas — `gol-smiles (G1–G6)`, os Gol Gates
+  `gate.gol.*`, `deep_verify`, `Transport`, `Setup Wizard` e `Design / Figma Integration` — e
+  teve a contagem de gates atualizada (**48 gates**, família `gol` incluída; apêndices C/D
+  completados com `verify tangerina/arch/i18n`, `raptor setup` e `raptor design`). O README
+  passou a documentar a captura determinística do Figma (`figma-rest`), o preset `gol-smiles`
+  e atualizou o badge de versão. Certificação do glossário avançada para `0.12.1`.
+
+### Fixed
+
+- **Correção factual no glossário:** `gate.release.crash_free_window` não existe no código (é
+  apenas uma menção *future*) — removido do catálogo de gates.
+
 ## [0.12.1] - 2026-06-13
 
 ### Changed

package/README.md

@@ -7,8 +7,8 @@
 [![npm](https://img.shields.io/npm/v/raptor-aios?color=ef4444&label=raptor-aios&logo=npm)](https://www.npmjs.com/package/raptor-aios)
 [![node](https://img.shields.io/badge/node-%E2%89%A5%2020-3c873a?logo=node.js&logoColor=white)](https://nodejs.org)
 [![platform](https://img.shields.io/badge/target-React%20Native-61dafb?logo=react&logoColor=black)](https://reactnative.dev)
-[![tests](https://img.shields.io/badge/tests-1019%20passing-22c55e)](#️-desenvolvimento-local)
-[![version](https://img.shields.io/badge/version-0.8.3-ef4444)](CHANGELOG.md)
+[![tests](https://img.shields.io/badge/tests-1356%20passing-22c55e)](#️-desenvolvimento-local)
+[![version](https://img.shields.io/badge/version-0.12.2-ef4444)](CHANGELOG.md)
 [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
 </div>
@@ -464,7 +464,7 @@ Declarar não é cumprir. O Raptor **mede** e compara com o declarado:
 
 |       Capacidade        |                                           Para que serve                                           |                         Comandos                         |
 | ----------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
-| 🎚️ **Presets**          | Conjuntos reusáveis de artigos + gates, empilháveis. Bundled: `mobile-opinionated`, `lean`.        | `raptor preset list · add · info · remove`               |
+| 🎚️ **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`               |
 | 🔁 **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` |
 | 🤖 **Agentes**           | Materializa os slash commands por agente.                                                          | `raptor add-agent` · `raptor list-agents`                |
 | 🧠 **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:
 | 🪝 **Hooks**             | Scripts disparados em **34 pontos** do ciclo (`before_*`/`after_*` de 17 comandos).                | `raptor hook list · run`                                 |
 | 📦 **Extensões**         | Pacotes self-contained (templates/gates/hooks/workflows).                                          | `raptor extension add · list · info · remove`            |
 | 🎟️ **Jira**             | Puxa issues do Jira (somente leitura) para semear specs.                                           | `raptor jira connect · status · pull · disconnect`       |
+| 🎨 **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` |
 | 📜 **Auditoria & trace** | Consulta a trilha de eventos e a rastreabilidade.                                                  | `raptor audit query · show` · `raptor trace`             |
 
 ### 🎟️ Integração com Jira
@@ -484,6 +485,20 @@ raptor new login --jira APP-1234    # semeia a spec a partir da issue
 
 > 📖 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).
 
+### 🎨 Integração com Figma (design determinístico)
+
+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).
+
+```bash
+raptor design connect               # provider figma-rest (Personal Access Token) — default, CI-friendly
+raptor new home --figma <url-figma> # captura tokens/telas/assets/fontes e semeia design/
+raptor design sync home             # re-captura idempotente (nunca sobrescreve o refino)
+```
+
+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`.
+
+> 📖 Detalhes, providers e limitações: [docs/design-figma-sync.md](docs/design-figma-sync.md) e [docs/design-gate.md](docs/design-gate.md).
+
 ---
 
 ## 📖 Referência de comandos CLI
@@ -493,11 +508,13 @@ raptor new login --jira APP-1234    # semeia a spec a partir da issue
 🌿 Branch/commit commit · scan
 🔬 Verificação   verify · verify a11y · verify perf · verify stores · verify os-matrix
                  verify architecture · verify audit · verify constitution
+                 verify tangerina · verify arch · verify i18n   (preset gol-smiles)
 📊 Status        status · doctor · trace · audit query · audit show
 ⚖️ Governança    gate list · gate approve · gate skip · repair constitution · hotfix · resync · upgrade
 🧩 Extensão      preset … · workflow … · skill … · mcp … · hook … · extension …
                  add-agent · list-agents · add-extension
 🎟️ Jira          jira connect · status · pull · disconnect
+🎨 Figma/Design  design connect · status · pull · sync · disconnect
 ```
 
 Rode `raptor <comando> --help` para os detalhes (flags, exemplos) de cada um.
@@ -546,7 +563,7 @@ Flags disponíveis:
 ├── raptor.yml               # ⚙️ config (preset, ai, git.branch_per_feature, commit_trailer)
 ├── raptor.manifest.json     # 📋 manifest de instalação
 ├── agents.yml · skills.yml · mcp.yml
-├── specs/<NNN-slug>/        # 📝 spec.md · plan.md · tasks.md · impl-log.md · audit.jsonl · checklists/
+├── specs/<NNN-slug>/        # 📝 spec.md · plan.md · tasks.md · impl-log.md · audit.jsonl · checklists/ · design/ (tokens.json · screens/ · assets-manifest.json)
 ├── templates/               # 🧱 cópia bundlada (commands/*.md + *-template.md)
 ├── memory/                  # 🧠 constitution copy · amendments.log · decisions.md · glossary.md
 ├── extensions/ · workflows/ · presets/ · hooks/ · scripts/ · cache/
@@ -564,9 +581,10 @@ Comece pelo **[📖 Glossário Canônico](docs/glossary.md)** — a referência
 
 |                             Documento                              |                                       Sobre                                        |
 | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |
-| **[📖 docs/glossary.md](docs/glossary.md)**                         | Glossário canônico: conceitos, hierarquias, catálogo de 42 gates e de comandos CLI |
+| **[📖 docs/glossary.md](docs/glossary.md)**                         | Glossário canônico: conceitos, hierarquias, catálogo de 48 gates e de comandos CLI |
 | [🧭 docs/setup-wizard.md](docs/setup-wizard.md)                     | Assistente de instalação `raptor setup`: onboarding, IA/IDE, preset, Jira/Figma    |
 | [🛡️ docs/readiness-gates.md](docs/readiness-gates.md)              | Gates de prontidão (`spec/plan/tasks.ready`) em detalhe                            |
+| [🎨 docs/design-figma-sync.md](docs/design-figma-sync.md)           | Captura determinística do Figma (`figma-rest`): tokens/telas/assets/fontes + flip REDISTRIBUIR |
 | [🎨 docs/design-gate.md](docs/design-gate.md)                       | Design gate, integração Figma e `assets-manifest.json`                             |
 | [🔗 docs/artifact-chain.md](docs/artifact-chain.md)                 | Cadeia de artefatos e rastreabilidade spec→plan→tasks→código                       |
 | [🎟️ docs/jira-spec-enrichment.md](docs/jira-spec-enrichment.md)    | Enriquecimento de spec a partir de cards do Jira                                   |
@@ -603,7 +621,7 @@ Monorepo pnpm (`packages/core` = `@raptor/core`, `packages/cli` = binário `rapt
 ```bash
 pnpm install
 pnpm build
-pnpm -r test && pnpm test:e2e     # 1019 testes (784 core + 201 cli + 34 e2e)
+pnpm -r test && pnpm test:e2e     # ~1356 testes (1071 core + ~251 cli + 34 e2e)
 
 # usar a CLI local em outro projeto:
 cd packages/cli && npm link        # ou: pnpm link --global

package/dist/_core/dist/git/repo.js

@@ -14,6 +14,15 @@ export function branchExists(exec, cwd, name) {
     });
     return r.status === 0;
 }
+export function listBranches(exec, cwd) {
+    const r = exec(["for-each-ref", "--format=%(refname:short)", "refs/heads", "refs/remotes"], { cwd });
+    if (r.status !== 0 || !r.stdout)
+        return [];
+    return r.stdout
+        .split("\n")
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
 export function isWorkingTreeClean(exec, cwd) {
     const r = exec(["status", "--porcelain"], { cwd });
     return r.status === 0 && r.stdout === "";

package/dist/_core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raptor/core",
-  "version": "0.12.1",
+  "version": "0.13.0",
   "type": "module",
   "main": "dist/index.js"
 }

package/dist/commands/new.js

@@ -3,7 +3,7 @@ import { BaseCommand } from "../base-command.js";
 import { step, heading } from "../shared/ui.js";
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, } from "node:fs";
 import { join } from "node:path";
-import { appendAuditEvent, buildCanonicalPrompt, deriveBranchName, executeWorkflow, extractFigmaRefs, hashString, inferKindFromJiraIssueType, loadAgentsConfig, mapDesignToSpecContext, mapIssueToSpecContext, parseFrontmatter, renderBundled, selectAgent, writeDesignScaffold, } from "../_core/dist/index.js";
+import { appendAuditEvent, buildCanonicalPrompt, deriveBranchName, execSyncGitExecutor, executeWorkflow, listBranches, extractFigmaRefs, hashString, inferKindFromJiraIssueType, loadAgentsConfig, mapDesignToSpecContext, mapIssueToSpecContext, parseFrontmatter, renderBundled, selectAgent, writeDesignScaffold, } from "../_core/dist/index.js";
 import { currentActor, readConfig, readInitOptions, requireProjectRoot, } from "../shared/project.js";
 import { ensureWorkItemBranch, resolveInteractive, } from "../shared/git-prompt.js";
 import { jiraConn, jiraReadyNonInteractive, openJiraClient, } from "../shared/jira.js";
@@ -14,6 +14,12 @@ import { waitForPhaseArtifact, } from "../shared/artifact-io.js";
 import { resolveWorkflow } from "../shared/workflow-resolver.js";
 import { writeFeaturePrompt } from "../shared/feature-prompt.js";
 import { cliCommandExecutor } from "../workflow/executor.js";
+function parseFeatureBranch(name) {
+    const m = /(?:^|\/)(\d{3})-(.+)$/.exec(name);
+    if (!m)
+        return null;
+    return { nnn: m[1], slug: (m[2] ?? "").split(".")[0] };
+}
 export default class New extends BaseCommand {
     static description = "Create a new feature spec in the current Raptor project";
     static examples = [
@@ -88,17 +94,25 @@ export default class New extends BaseCommand {
         if (!/^[a-z][a-z0-9-]*$/.test(args.slug)) {
             this.error("Slug must be kebab-case (lowercase letters, digits, hyphens; starts with a letter).");
         }
-        const existing = readdirSync(specsDir).filter((d) => /^\d{3}-/.test(d));
+        const existing = existsSync(specsDir)
+            ? readdirSync(specsDir).filter((d) => /^\d{3}-/.test(d))
+            : [];
+        const branchFeatures = listBranches(execSyncGitExecutor, root)
+            .map(parseFeatureBranch)
+            .filter((b) => b !== null);
         const reusedDir = existing.find((d) => d.replace(/^\d{3}-/, "") === args.slug);
-        const reusing = reusedDir !== undefined;
-        const numbers = existing
+        const reusedBranch = branchFeatures.find((b) => b.slug === args.slug);
+        const reusedNnn = reusedDir
+            ? reusedDir.slice(0, 3)
+            : reusedBranch?.nnn;
+        const reusing = reusedNnn !== undefined;
+        const dirNumbers = existing
             .map((d) => parseInt(d.slice(0, 3), 10))
             .filter((n) => !Number.isNaN(n));
-        const nextN = (numbers.length ? Math.max(...numbers) : 0) + 1;
-        const nnn = reusing
-            ? reusedDir.slice(0, 3)
-            : String(nextN).padStart(3, "0");
-        const featureName = reusing ? reusedDir : `${nnn}-${args.slug}`;
+        const branchNumbers = branchFeatures.map((b) => parseInt(b.nnn, 10));
+        const maxN = Math.max(0, ...dirNumbers, ...branchNumbers);
+        const nnn = reusing ? reusedNnn : String(maxN + 1).padStart(3, "0");
+        const featureName = reusing && reusedDir ? reusedDir : `${nnn}-${args.slug}`;
         const featureDir = join(specsDir, featureName);
         const actor0 = currentActor("human");
         runBeforeHook(this, {

package/dist/shared/git-prompt.js

@@ -21,7 +21,7 @@ export async function confirmPrompt(question) {
 }
 async function promptDirtyTree(cmd, branchName) {
     cmd.log("");
-    cmd.warn(`Your working tree has uncommitted changes, and the new branch "${branchName}" forks from the base branch.`);
+    cmd.warn(`Your working tree has uncommitted changes, and the new branch "${branchName}" will fork from the current branch.`);
     cmd.log("  How do you want to proceed?");
     cmd.log("    1) stash  — set the changes aside, branch from a clean base");
     cmd.log("    2) carry  — take the uncommitted changes onto the new branch");
@@ -86,7 +86,7 @@ export async function ensureWorkItemBranch(input) {
         }
         return { outcome: "switched", branch: branchName, base: null };
     }
-    const base = defaultBaseBranch(exec, root);
+    const base = currentBranch(exec, root) ?? defaultBaseBranch(exec, root);
     const st = createBranch(exec, root, branchName, base);
     if (st !== 0) {
         const hint = carry

package/dist/shared/project.js

@@ -59,17 +59,30 @@ export function activePresetIds(cfg) {
         ordered.push(singular);
     return ordered;
 }
-export function featureDir(root, slug) {
-    const specs = join(root, '.raptor', 'specs');
-    const dirs = existsSync(specs) ? readdirSync(specs) : [];
-    const match = dirs.find((d) => d === slug || d.endsWith(`-${slug}`));
-    if (match)
-        return join(specs, match);
+function resolveFeatureDir(base, slug) {
+    if (!existsSync(base))
+        return null;
+    const dirs = readdirSync(base);
+    const matches = dirs.filter((d) => d === slug || d.replace(/^\d{3}-/, '') === slug);
+    if (matches.length === 1)
+        return join(base, matches[0]);
+    if (matches.length > 1) {
+        throw new Error(`Ambiguous feature '${slug}' — matches ${matches
+            .sort()
+            .join(', ')}. Pass the full directory name (e.g. ${matches.sort()[0]}).`);
+    }
     if (/^\d{3}-/.test(slug)) {
-        const direct = join(specs, slug);
+        const direct = join(base, slug);
         if (existsSync(direct))
             return direct;
     }
+    return null;
+}
+export function featureDir(root, slug) {
+    const specs = join(root, '.raptor', 'specs');
+    const resolved = resolveFeatureDir(specs, slug);
+    if (resolved)
+        return resolved;
     throw new Error(`feature not found: ${slug} (under ${specs})`);
 }
 export function auditableDir(root, slug) {
@@ -78,17 +91,9 @@ export function auditableDir(root, slug) {
         join(root, '.raptor', 'hotfixes'),
     ];
     for (const base of candidates) {
-        if (!existsSync(base))
-            continue;
-        const dirs = readdirSync(base);
-        const match = dirs.find((d) => d === slug || d.endsWith(`-${slug}`));
-        if (match)
-            return join(base, match);
-        if (/^\d{3}-/.test(slug)) {
-            const direct = join(base, slug);
-            if (existsSync(direct))
-                return direct;
-        }
+        const resolved = resolveFeatureDir(base, slug);
+        if (resolved)
+            return resolved;
     }
     throw new Error(`slug not found: ${slug} (checked .raptor/specs and .raptor/hotfixes)`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "raptor-aios",
-  "version": "0.12.1",
+  "version": "0.13.0",
   "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.",
   "type": "module",
   "bin": {

package/scripts/prepare-npm.mjs

@@ -29,7 +29,7 @@ const CLI = join(ROOT, "packages", "cli");
 const CORE = join(ROOT, "packages", "core");
 const OUT = join(ROOT, "build", "npm");
 
-const VERSION = "0.12.1";
+const VERSION = "0.13.0";
 
 function log(msg) {
   process.stdout.write(`  ${msg}\n`);