raptor-aios 0.11.0 → 0.12.1

package/CHANGELOG.md

@@ -5,6 +5,37 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [0.12.1] - 2026-06-13
+
+### Changed
+
+- **Documentação em pt-BR.** Toda a documentação em `docs/` passa a ser escrita em
+  português brasileiro (identificadores técnicos — comandos `/raptor-*`, gates `gate.*`,
+  paths e campos de frontmatter — permanecem em inglês). Traduzidas e corrigidas contra o
+  código real: `artifact-chain.md` e `state-model.md` (comandos legados `/rpt.*` →
+  `/raptor-*`, criação de feature via `raptor new`, constituição em
+  `.raptor/constitution.md`) e `script-contract.md`.
+- **`docs/spec-kit-parity.md` reescrita.** Comparação Raptor × Spec Kit confirmada por
+  análise de código: paridade 1:1 dos 9 comandos + a camada de enforcement (constituição
+  executável C1–C5/M1–M6, motor de 36+ gates, cadeia de staleness, verificação no edge) e
+  de captura (Jira/Figma determinísticos). Dados do Spec Kit atualizados a partir da fonte
+  oficial (comandos essenciais vs opcionais, 30+ agentes, tagline) e enriquecida com 5
+  diagramas mermaid. Escopo honesto: só `verify perf` roda o app; não há `verify crash`.
+
+> Release só-docs: a pasta `docs/` não é empacotada no npm, então o pacote instalável é
+> equivalente ao `0.12.0` (muda apenas o CHANGELOG e a versão).
+
+## [0.12.0] - 2026-06-13
+
+### Added
+
+- **`raptor setup` — menu de instalação interativo + onboarding (`packages/cli/src/commands/setup.ts`).** Uma porta de entrada guiada por setas (via `@clack/prompts`) que conduz, fase a fase: ❶ **onboarding** (a essência do Raptor, pulável com `--skip-intro`); ❷ **ponto de partida** (projeto do zero vs. existente, com detecção de stack do `package.json`); ❸ **ambiente em duas perguntas** — **IDE** (VS Code, Cursor, Antigravity, JetBrains, terminal) → **IA** (Claude Code, Copilot, Gemini, Codex), filtradas em cascata e mapeadas para a *agent key* correta; ❹ **preset** (com a sugestão da stack destacada); ❺ **Jira/Figma "configurar depois"** (grava o bloco pronto no `raptor.yml`, sem disparar OAuth no fluxo); ❻ **revisão e aplicação**.
+  - **Coleta separada da execução.** O wizard apenas monta um `SetupPlan`; `applySetupPlan` o executa reusando a lógica de `init` — extraída intacta para `performInit` (`shared/init-core.ts`) —, então o `.raptor/` gerado é byte-equivalente ao de `raptor init`.
+  - **Caminho não-interativo** (`--non-interactive --ide --ai --preset …`, ou simplesmente a ausência de TTY) para CI/scripts, compartilhando o MESMO plano do wizard — o que mantém a experiência interativa testável sem dirigir um terminal.
+  - **Reconfigure não-destrutivo:** `raptor setup --force` agora preserva os blocos do usuário no `raptor.yml` (`git` com `commit_trailer`/`kind_prefixes`, `gates`, conexões `jira`/`design` — inclusive desconectadas-mas-configuradas, que retêm `cloud_id`/`custom_fields`/token — e o nome do projeto), em vez de revertê-los aos defaults do template.
+  - Banner ASCII responsivo (degrada em terminais estreitos, respeita `NO_COLOR`/não-TTY) e exit codes corretos (cancelar ou falhar → não-zero; recusar a aplicação → zero).
+  - Endurecido por revisão adversarial multi-dimensão (correção, fidelidade de API `@clack`, paridade da extração de `init`, contrato de config, reuso), com etapa cética por achado e o ciclo repetido até convergir.
+
 ## [0.11.0] - 2026-06-12
 
 ### Added

package/README.md

@@ -22,7 +22,7 @@
 ```bash
 npm install -g raptor-aios
 cd meu-app-react-native
-raptor init --ai=claude-code --preset=mobile-opinionated
+raptor setup        # 🧭 assistente guiado: IA/IDE, preset, Jira/Figma (ou 'raptor init' direto)
 raptor new login-biometrico -d "Permitir login com Face ID / digital"
 #  → cria a feature E já troca para a branch feat/001-login-biometrico
 ```
@@ -95,11 +95,19 @@ raptor doctor      # 🩺 checagem de saúde do ambiente e do projeto
 
 ### 1️⃣ Inicialize o Raptor
 
+A forma **guiada** — um assistente interativo (navegação por setas) que apresenta o Raptor e coleta IA/IDE, preset e integrações Jira/Figma:
+
+```bash
+raptor setup
+```
+
+Ou, **direto e não-interativo** (ideal para CI/scripts):
+
 ```bash
 raptor init --ai=claude-code --preset=mobile-opinionated
 ```
 
-Isso cria a pasta `.raptor/`, a **constituição** do projeto, e materializa os **slash commands** em `.claude/commands/` (ou `.cursor/`, etc., conforme o agente).
+Qualquer um cria a pasta `.raptor/`, a **constituição** do projeto, e materializa os **slash commands** em `.claude/commands/` (ou `.cursor/`, etc., conforme o agente).
 
 |             Flag              |                                                Para que serve                                                |
 | ----------------------------- | ------------------------------------------------------------------------------------------------------------ |
@@ -481,7 +489,7 @@ raptor new login --jira APP-1234    # semeia a spec a partir da issue
 ## 📖 Referência de comandos CLI
 
 ```text
-🔄 Ciclo         init · new · clarify · plan · tasks · analyze · checklist · implement · approve · taskstoissues
+🔄 Ciclo         setup · init · new · clarify · plan · tasks · analyze · checklist · implement · approve · taskstoissues
 🌿 Branch/commit commit · scan
 🔬 Verificação   verify · verify a11y · verify perf · verify stores · verify os-matrix
                  verify architecture · verify audit · verify constitution
@@ -557,6 +565,7 @@ 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/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-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                       |

package/dist/_core/package.json

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

package/dist/commands/init.js

@@ -1,10 +1,8 @@
 import { Flags } from "@oclif/core";
 import { BaseCommand } from "../base-command.js";
-import { chmodSync, existsSync, mkdirSync, writeFileSync, } from "node:fs";
-import { basename, join } from "node:path";
-import { appendAuditEvent, buildContextBlock, coreBlock, CORE_VERSION, createManifest, detectInstalledAgents, generateAgentsYaml, getAgentByKind, getPreset, hashString, knownPresetIds, resolvePresetId, materializeSlashCommands, renderBundled, renderPresetArticles, renderPresetsArticles, SELECTABLE_AGENT_KEYS, upsertContextFile, VERSION, } from "../_core/dist/index.js";
-import { currentActor } from "../shared/project.js";
-import { collectKnowledgeRefs, installBundledExtensions, installShellScripts, installTemplates, } from "../shared/scaffold.js";
+import { basename } from "node:path";
+import { CORE_VERSION, SELECTABLE_AGENT_KEYS } from "../_core/dist/index.js";
+import { describeCi, describeHooks, InitExistsError, performInit, } from "../shared/init-core.js";
 export default class Init extends BaseCommand {
     static description = "Initialize a Raptor project in the current directory";
     static examples = [
@@ -56,184 +54,31 @@ export default class Init extends BaseCommand {
     };
     async run() {
         const { flags } = await this.parse(Init);
-        const cwd = process.cwd();
-        const raptorDir = join(cwd, ".raptor");
-        if (existsSync(raptorDir) && !flags.force) {
-            this.error("A .raptor/ directory already exists here. Use --force to overwrite.");
+        let result;
+        try {
+            result = performInit({
+                cwd: process.cwd(),
+                projectName: flags["project-name"],
+                preset: flags.preset,
+                ai: flags.ai,
+                script: flags.script,
+                branchNumbering: flags["branch-numbering"],
+                noGit: flags["no-git"],
+                withCi: flags["with-ci"],
+                withHooks: flags["with-hooks"],
+                force: flags.force,
+            }, this);
         }
-        const projectName = flags["project-name"] ?? basename(cwd);
-        const createdAt = new Date().toISOString();
-        const subdirs = [
-            "specs",
-            "memory",
-            "templates",
-            "templates/overrides",
-            "extensions",
-            "workflows",
-            "presets",
-            "agents",
-            "skills",
-            "scripts",
-            "scripts/bash",
-            "scripts/powershell",
-            "cache",
-        ];
-        mkdirSync(raptorDir, { recursive: true });
-        for (const sub of subdirs)
-            mkdirSync(join(raptorDir, sub), { recursive: true });
-        const rawPresetIds = flags.preset
-            .split(",")
-            .map((s) => s.trim())
-            .filter((s) => s.length > 0);
-        const resolved = rawPresetIds.map((raw) => ({
-            raw,
-            id: resolvePresetId(raw) ?? raw,
-            preset: getPreset(raw),
-        }));
-        for (const r of resolved) {
-            if (!r.preset) {
-                this.warn(`unknown preset "${r.raw}" — known presets: ${knownPresetIds().join(", ")}. It will have no constitution articles.`);
+        catch (err) {
+            if (err instanceof InitExistsError) {
+                this.error(err.message);
             }
+            throw err;
         }
-        const presets = resolved.map((r) => r.preset).filter((p) => Boolean(p));
-        const presetIds = resolved.map((r) => r.id);
-        const preset = presets[0];
-        const presetId = presetIds[0];
-        const presetArticles = presets.length > 1
-            ? renderPresetsArticles(presets)
-            : preset
-                ? renderPresetArticles(preset)
-                : "";
-        const presetLabel = presetIds.join(", ");
-        const allArticleIds = presets.length
-            ? presets.flatMap((p) => p.articles.map((a) => a.id))
-            : undefined;
-        const presetsBlock = presetIds.length > 1
-            ? `presets:\n${presetIds.map((id) => `  - ${id}`).join("\n")}`
-            : `preset: ${presetId}`;
-        const raptorYml = renderBundled("raptorYml", {
-            raptorVersion: VERSION,
-            projectName,
-            createdAt,
-            presetsBlock,
-        });
-        writeFileSync(join(raptorDir, "raptor.yml"), raptorYml);
-        const manifest = createManifest({
-            raptor_version: VERSION,
-            project_name: projectName,
-            integration: flags.ai,
-            script_type: flags.script,
-            branch_numbering: flags["branch-numbering"],
-            preset: presetId,
-            scripts_installed: [],
-            templates_installed: [],
-            extensions_registered: [],
-        });
-        writeFileSync(join(raptorDir, "raptor.manifest.json"), JSON.stringify(manifest, null, 2) + "\n");
-        const initOptions = {
-            ai: flags.ai,
-            script_type: flags.script,
-            branch_numbering: flags["branch-numbering"],
-            preset: presetId,
-            no_git: flags["no-git"],
-            created_at: createdAt,
-        };
-        writeFileSync(join(raptorDir, "init-options.json"), JSON.stringify(initOptions, null, 2) + "\n");
-        const constitution = renderBundled("constitution", {
-            projectName,
-            preset: presetLabel,
-            coreBlock: coreBlock(),
-            presetArticles,
-        });
-        const constitutionPath = join(raptorDir, "constitution.md");
-        writeFileSync(constitutionPath, constitution);
-        writeFileSync(join(raptorDir, "memory", "constitution.md"), constitution);
-        writeFileSync(join(raptorDir, "memory", "amendments.log"), "");
-        writeFileSync(join(raptorDir, "memory", "decisions.md"), "# Architecture Decision Records\n\n");
-        writeFileSync(join(raptorDir, "memory", "glossary.md"), "# Project Glossary\n\n");
-        writeFileSync(join(raptorDir, ".gitignore"), "cache/\n*.log\n");
-        installShellScripts(this, raptorDir, manifest);
-        installTemplates(raptorDir);
-        installBundledExtensions(this, raptorDir, manifest, presetIds);
-        const knowledgeRefs = collectKnowledgeRefs(raptorDir);
-        const installedAgents = detectInstalledAgents();
-        const primaryAgent = getAgentByKind(flags.ai);
-        if (primaryAgent && !installedAgents.some((a) => a.id === primaryAgent.id)) {
-            this.warn(`Primary agent "${flags.ai}" CLI was not detected on PATH — materializing its commands anyway.`);
-        }
-        const targetAgents = primaryAgent
-            ? [
-                primaryAgent,
-                ...installedAgents.filter((a) => a.id !== primaryAgent.id),
-            ]
-            : installedAgents;
-        const agentsYamlContent = generateAgentsYaml(targetAgents.map((a) => ({
-            id: a.id,
-            kind: a.id,
-            capabilities: [...a.capabilities],
-        })));
-        const agentsYamlPath = join(raptorDir, "agents.yml");
-        writeFileSync(agentsYamlPath, agentsYamlContent);
-        const contextBlock = buildContextBlock({
-            projectName,
-            preset: presetLabel,
-            constitutionArticles: allArticleIds,
-            knowledge: knowledgeRefs,
-        });
-        for (const agent of targetAgents) {
-            if (agent.contextFile) {
-                const filePath = join(cwd, agent.contextFile);
-                upsertContextFile(filePath, contextBlock);
-            }
-        }
-        const allMaterialized = [];
-        for (const agent of targetAgents) {
-            if (agent.id === "human")
-                continue;
-            try {
-                const result = materializeSlashCommands({
-                    projectRoot: cwd,
-                    projectName,
-                    adapter: agent,
-                    constitutionArticles: allArticleIds,
-                    presetId: presetId,
-                });
-                allMaterialized.push({
-                    agentId: agent.id,
-                    count: result.commands.length,
-                    paths: result.commands.map((c) => c.path),
-                });
-            }
-            catch (err) {
-                this.warn(`Failed to materialize slash commands for ${agent.displayName}: ${err instanceof Error ? err.message : String(err)}`);
-            }
-        }
-        const amendmentsLog = join(raptorDir, "memory", "amendments.log");
-        const actor = currentActor("human");
-        appendAuditEvent(amendmentsLog, {
-            event: "constitution.initialized",
-            command: "raptor init",
-            actor: { user: actor.user, via: actor.via },
-            outputs: [
-                { path: ".raptor/constitution.md", hash: hashString(constitution) },
-                { path: ".raptor/agents.yml", hash: hashString(agentsYamlContent) },
-            ],
-            meta: {
-                core_version: CORE_VERSION,
-                preset: presetLabel,
-                preset_version: preset?.version,
-                preset_articles: allArticleIds,
-                project: projectName,
-                detected_agents: installedAgents.map((a) => a.id),
-                configured_agents: targetAgents.map((a) => a.id),
-            },
-        });
-        const ciResult = flags["with-ci"]
-            ? this.installCiWorkflow(cwd)
-            : { status: "disabled" };
-        const hooksResult = flags["with-hooks"]
-            ? this.installGitHooks(cwd)
-            : { status: "disabled" };
+        this.renderSummary(result, flags);
+    }
+    renderSummary(result, flags) {
+        const { raptorDir, projectName, presets, presetLabel, allArticleIds, targetAgents, materialized, primaryAgentId, agentsYamlPath, manifestPath, ciResult, hooksResult, } = result;
         this.log(`✓ Initialized Raptor project in ${raptorDir}`);
         this.log(`  Project:  ${projectName}`);
         if (presets.length > 1) {
@@ -242,6 +87,7 @@ export default class Init extends BaseCommand {
             this.log(`  Presets:  ${presetLabel} (${presets.length} stacked, ${totalArticles} articles, ${totalGates} gates)`);
         }
         else {
+            const preset = presets[0];
             this.log(`  Preset:   ${flags.preset}${preset ? ` (v${preset.version}, ${preset.articles.length} articles, ${preset.gates.length} gates)` : " (unknown)"}`);
         }
         this.log(`  Core:     v${CORE_VERSION}`);
@@ -249,7 +95,7 @@ export default class Init extends BaseCommand {
             this.log(`  Articles: ${allArticleIds.join(", ")}`);
         }
         this.log(`  Agents:   ${targetAgents.map((a) => `${a.displayName} (${a.id})`).join(", ")}`);
-        for (const m of allMaterialized) {
+        for (const m of materialized) {
             this.log(`  Slash:    ${m.count} commands materialized for ${m.agentId}`);
         }
         this.log(`  Config:   ${agentsYamlPath}`);
@@ -257,11 +103,11 @@ export default class Init extends BaseCommand {
         this.log(`  Hooks:    ${describeHooks(hooksResult)}`);
         this.log("");
         this.log(`  AI:       ${flags.ai} (script: ${flags.script}, branching: ${flags["branch-numbering"]})`);
-        this.log(`  Manifest: ${join(raptorDir, "raptor.manifest.json")}`);
+        this.log(`  Manifest: ${manifestPath}`);
         this.log("Next steps:");
         this.log(`  1. Review ${raptorDir}/constitution.md (RAPTOR-CORE block is immutable)`);
         this.log(`  2. Review ${raptorDir}/agents.yml (agent policy + fallback chain)`);
-        const primaryMat = allMaterialized.find((m) => primaryAgent && m.agentId === primaryAgent.id) ?? allMaterialized[0];
+        const primaryMat = materialized.find((m) => primaryAgentId && m.agentId === primaryAgentId) ?? materialized[0];
         const slashList = primaryMat
             ? primaryMat.paths
                 .map((p) => `/${basename(p).replace(/\.[^.]+$/, "")}`)
@@ -270,61 +116,4 @@ export default class Init extends BaseCommand {
         this.log(`  3. Use slash commands: ${slashList}`);
         this.log(`  4. Or run 'raptor new <slug>' to create your first feature directly`);
     }
-    installCiWorkflow(cwd) {
-        const dir = join(cwd, ".github", "workflows");
-        const path = join(dir, "raptor-verify.yml");
-        if (existsSync(path)) {
-            return { status: "skipped-existing", path };
-        }
-        mkdirSync(dir, { recursive: true });
-        const content = renderBundled("ghaWorkflow", { raptorVersion: VERSION });
-        writeFileSync(path, content);
-        return { status: "installed", path };
-    }
-    installGitHooks(cwd) {
-        const gitDir = join(cwd, ".git");
-        if (!existsSync(gitDir)) {
-            return { status: "skipped-no-git" };
-        }
-        const hooksDir = join(gitDir, "hooks");
-        mkdirSync(hooksDir, { recursive: true });
-        const hooks = [
-            { name: "pre-commit", key: "preCommitHook" },
-            { name: "pre-push", key: "prePushHook" },
-            { name: "commit-msg", key: "commitMsgHook" },
-        ];
-        const installed = [];
-        const skipped = [];
-        for (const h of hooks) {
-            const path = join(hooksDir, h.name);
-            if (existsSync(path)) {
-                skipped.push(h.name);
-                continue;
-            }
-            const content = renderBundled(h.key, {});
-            writeFileSync(path, content);
-            chmodSync(path, 0o755);
-            installed.push(h.name);
-        }
-        return { status: "ok", installed, skipped };
-    }
-}
-function describeCi(r) {
-    if (r.status === "disabled")
-        return "disabled (--no-with-ci)";
-    if (r.status === "skipped-existing")
-        return `skipped (${r.path} already exists)`;
-    return `installed at ${r.path}`;
-}
-function describeHooks(r) {
-    if (r.status === "disabled")
-        return "disabled (--no-with-hooks)";
-    if (r.status === "skipped-no-git")
-        return "skipped (.git/ not found — run 'git init' first)";
-    const parts = [];
-    if (r.installed.length > 0)
-        parts.push(`installed: ${r.installed.join(", ")}`);
-    if (r.skipped.length > 0)
-        parts.push(`skipped (already exist): ${r.skipped.join(", ")}`);
-    return parts.length > 0 ? parts.join("; ") : "nothing to do";
 }

package/dist/commands/setup.js

@@ -0,0 +1,149 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand } from "../base-command.js";
+import { applySetupPlan, buildSetupPlan, } from "../shared/setup/plan.js";
+import { describeCi, describeHooks, InitExistsError, } from "../shared/init-core.js";
+import { aisForIde, IDES, resolveAgentKey, } from "../shared/setup/agent-resolver.js";
+import { detectProjectStack } from "../shared/setup/detect-stack.js";
+import { resolveInteractive } from "../shared/git-prompt.js";
+import { runSetupWizard } from "../shared/setup/wizard.js";
+const IDE_IDS = IDES.map((i) => i.id);
+export default class Setup extends BaseCommand {
+    static description = "Guided interactive setup — onboarding + project initialization (arrow-key wizard)";
+    static examples = [
+        "<%= config.bin %> setup",
+        "<%= config.bin %> setup --ide=vscode --ai=claude-code",
+        "<%= config.bin %> setup --non-interactive --ide=terminal --ai=claude-code --preset=mobile-opinionated",
+    ];
+    static flags = {
+        ide: Flags.string({
+            description: `Target IDE/environment (${IDE_IDS.join(", ")})`,
+            options: IDE_IDS,
+        }),
+        ai: Flags.string({
+            description: "AI assistant id within the chosen IDE (valid values depend on --ide)",
+        }),
+        preset: Flags.string({
+            description: "Constitution preset, or comma-separated stack",
+        }),
+        "project-name": Flags.string({
+            description: "Project display name (default: current directory name)",
+        }),
+        "jira-later": Flags.boolean({
+            description: "Write a disabled jira: block so 'raptor jira connect' is one step away",
+            default: false,
+        }),
+        "figma-later": Flags.boolean({
+            description: "Write a disabled design: block so 'raptor design connect' is one step away",
+            default: false,
+        }),
+        "skip-intro": Flags.boolean({
+            description: "Skip the onboarding intro in the wizard",
+            default: false,
+        }),
+        "non-interactive": Flags.boolean({
+            description: "Run without prompts (requires --ide and --ai)",
+            default: false,
+        }),
+        force: Flags.boolean({
+            description: "Overwrite an existing .raptor/ directory",
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(Setup);
+        const cwd = process.cwd();
+        if (resolveInteractive(flags["non-interactive"])) {
+            const outcome = await runSetupWizard({
+                cwd,
+                force: flags.force,
+                skipIntro: flags["skip-intro"],
+                defaults: {
+                    ide: flags.ide,
+                    ai: flags.ai,
+                    preset: flags.preset,
+                    projectName: flags["project-name"],
+                    jiraLater: flags["jira-later"],
+                    figmaLater: flags["figma-later"],
+                },
+            });
+            if (outcome === "cancelled" || outcome === "failed")
+                this.exit(1);
+            return;
+        }
+        const answers = this.answersFromFlags(flags, cwd);
+        const plan = this.buildPlanOrFail(answers, cwd, flags.force);
+        const result = this.applyOrFail(plan);
+        this.renderSummary(result, plan);
+    }
+    answersFromFlags(flags, cwd) {
+        const ide = flags.ide;
+        const ai = flags.ai;
+        if (!ide || !ai) {
+            this.error("Non-interactive setup requires --ide and --ai.\n" +
+                "Example: raptor setup --non-interactive --ide=terminal --ai=claude-code");
+        }
+        if (!resolveAgentKey(ide, ai)) {
+            const valid = aisForIde(ide).map((a) => a.id).join(", ") || "(none)";
+            this.error(`AI "${ai}" is not valid for IDE "${ide}". Valid: ${valid}`);
+        }
+        const stack = detectProjectStack(cwd);
+        const preset = flags.preset ?? stack.suggestedPreset ?? "mobile-opinionated";
+        return {
+            startingPoint: stack.isBrownfield ? "existing" : "scratch",
+            projectName: flags["project-name"],
+            ide,
+            ai,
+            preset,
+            jiraLater: flags["jira-later"],
+            figmaLater: flags["figma-later"],
+        };
+    }
+    buildPlanOrFail(answers, cwd, force) {
+        try {
+            return buildSetupPlan(answers, { cwd, force });
+        }
+        catch (err) {
+            this.error(err instanceof Error ? err.message : String(err));
+        }
+    }
+    applyOrFail(plan) {
+        try {
+            return applySetupPlan(plan, this);
+        }
+        catch (err) {
+            if (err instanceof InitExistsError) {
+                this.error(`${err.message} Use 'raptor setup --force' to reconfigure.`);
+            }
+            throw err;
+        }
+    }
+    renderSummary(result, plan) {
+        const { init } = result;
+        this.log(`✓ Raptor setup complete in ${init.raptorDir}`);
+        this.log(`  Project:  ${init.projectName}`);
+        this.log(`  Preset:   ${init.presetLabel}`);
+        this.log(`  Agent:    ${plan.primaryAgentKey}`);
+        for (const m of init.materialized) {
+            this.log(`  Slash:    ${m.count} commands materialized for ${m.agentId}`);
+        }
+        this.log(`  CI:       ${describeCi(init.ciResult)}`);
+        this.log(`  Hooks:    ${describeHooks(init.hooksResult)}`);
+        if (result.jiraPreserved) {
+            this.log("  Jira:     existing config preserved");
+        }
+        else if (result.jiraConfigured) {
+            this.log("  Jira:     configured later (run 'raptor jira connect')");
+        }
+        if (result.figmaPreserved) {
+            this.log("  Figma:    existing config preserved");
+        }
+        else if (result.figmaConfigured) {
+            this.log("  Figma:    configured later (run 'raptor design connect')");
+        }
+        this.log("Next steps:");
+        this.log(plan.startingPoint === "existing"
+            ? "  1. raptor new <slug> — specify a feature over your existing code"
+            : "  1. raptor new <slug> — create your first feature");
+        this.log("  2. raptor status — see the project at a glance");
+    }
+}

package/dist/shared/init-core.js

@@ -0,0 +1,260 @@
+import { chmodSync, existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import { appendAuditEvent, buildContextBlock, coreBlock, CORE_VERSION, createManifest, detectInstalledAgents, generateAgentsYaml, getAgentByKind, getPreset, hashString, knownPresetIds, resolvePresetId, materializeSlashCommands, renderBundled, renderPresetArticles, renderPresetsArticles, upsertContextFile, VERSION, } from "../_core/dist/index.js";
+import { currentActor } from "./project.js";
+import { collectKnowledgeRefs, installBundledExtensions, installShellScripts, installTemplates, } from "./scaffold.js";
+export class InitExistsError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InitExistsError";
+    }
+}
+export function performInit(opts, logger) {
+    const cwd = opts.cwd;
+    const raptorDir = join(cwd, ".raptor");
+    if (existsSync(raptorDir) && !opts.force) {
+        throw new InitExistsError("A .raptor/ directory already exists here. Use --force to overwrite.");
+    }
+    const projectName = opts.projectName ?? basename(cwd);
+    const createdAt = new Date().toISOString();
+    const subdirs = [
+        "specs",
+        "memory",
+        "templates",
+        "templates/overrides",
+        "extensions",
+        "workflows",
+        "presets",
+        "agents",
+        "skills",
+        "scripts",
+        "scripts/bash",
+        "scripts/powershell",
+        "cache",
+    ];
+    mkdirSync(raptorDir, { recursive: true });
+    for (const sub of subdirs)
+        mkdirSync(join(raptorDir, sub), { recursive: true });
+    const rawPresetIds = opts.preset
+        .split(",")
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+    const resolved = rawPresetIds.map((raw) => ({
+        raw,
+        id: resolvePresetId(raw) ?? raw,
+        preset: getPreset(raw),
+    }));
+    for (const r of resolved) {
+        if (!r.preset) {
+            logger.warn(`unknown preset "${r.raw}" — known presets: ${knownPresetIds().join(", ")}. It will have no constitution articles.`);
+        }
+    }
+    const presets = resolved
+        .map((r) => r.preset)
+        .filter((p) => Boolean(p));
+    const presetIds = resolved.map((r) => r.id);
+    const preset = presets[0];
+    const presetId = presetIds[0];
+    const presetArticles = presets.length > 1
+        ? renderPresetsArticles(presets)
+        : preset
+            ? renderPresetArticles(preset)
+            : "";
+    const presetLabel = presetIds.join(", ");
+    const allArticleIds = presets.length
+        ? presets.flatMap((p) => p.articles.map((a) => a.id))
+        : undefined;
+    const presetsBlock = presetIds.length > 1
+        ? `presets:\n${presetIds.map((id) => `  - ${id}`).join("\n")}`
+        : `preset: ${presetId}`;
+    const raptorYml = renderBundled("raptorYml", {
+        raptorVersion: VERSION,
+        projectName,
+        createdAt,
+        presetsBlock,
+    });
+    writeFileSync(join(raptorDir, "raptor.yml"), raptorYml);
+    const manifest = createManifest({
+        raptor_version: VERSION,
+        project_name: projectName,
+        integration: opts.ai,
+        script_type: opts.script,
+        branch_numbering: opts.branchNumbering,
+        preset: presetId,
+        scripts_installed: [],
+        templates_installed: [],
+        extensions_registered: [],
+    });
+    const manifestPath = join(raptorDir, "raptor.manifest.json");
+    writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + "\n");
+    const initOptions = {
+        ai: opts.ai,
+        script_type: opts.script,
+        branch_numbering: opts.branchNumbering,
+        preset: presetId,
+        no_git: opts.noGit,
+        created_at: createdAt,
+    };
+    writeFileSync(join(raptorDir, "init-options.json"), JSON.stringify(initOptions, null, 2) + "\n");
+    const constitution = renderBundled("constitution", {
+        projectName,
+        preset: presetLabel,
+        coreBlock: coreBlock(),
+        presetArticles,
+    });
+    writeFileSync(join(raptorDir, "constitution.md"), constitution);
+    writeFileSync(join(raptorDir, "memory", "constitution.md"), constitution);
+    writeFileSync(join(raptorDir, "memory", "amendments.log"), "");
+    writeFileSync(join(raptorDir, "memory", "decisions.md"), "# Architecture Decision Records\n\n");
+    writeFileSync(join(raptorDir, "memory", "glossary.md"), "# Project Glossary\n\n");
+    writeFileSync(join(raptorDir, ".gitignore"), "cache/\n*.log\n");
+    installShellScripts(logger, raptorDir, manifest);
+    installTemplates(raptorDir);
+    installBundledExtensions(logger, raptorDir, manifest, presetIds);
+    const knowledgeRefs = collectKnowledgeRefs(raptorDir);
+    const installedAgents = detectInstalledAgents();
+    const primaryAgent = getAgentByKind(opts.ai);
+    if (primaryAgent && !installedAgents.some((a) => a.id === primaryAgent.id)) {
+        logger.warn(`Primary agent "${opts.ai}" CLI was not detected on PATH — materializing its commands anyway.`);
+    }
+    const targetAgents = primaryAgent
+        ? [primaryAgent, ...installedAgents.filter((a) => a.id !== primaryAgent.id)]
+        : installedAgents;
+    const agentsYamlContent = generateAgentsYaml(targetAgents.map((a) => ({
+        id: a.id,
+        kind: a.id,
+        capabilities: [...a.capabilities],
+    })));
+    const agentsYamlPath = join(raptorDir, "agents.yml");
+    writeFileSync(agentsYamlPath, agentsYamlContent);
+    const contextBlock = buildContextBlock({
+        projectName,
+        preset: presetLabel,
+        constitutionArticles: allArticleIds,
+        knowledge: knowledgeRefs,
+    });
+    for (const agent of targetAgents) {
+        if (agent.contextFile) {
+            upsertContextFile(join(cwd, agent.contextFile), contextBlock);
+        }
+    }
+    const materialized = [];
+    for (const agent of targetAgents) {
+        if (agent.id === "human")
+            continue;
+        try {
+            const result = materializeSlashCommands({
+                projectRoot: cwd,
+                projectName,
+                adapter: agent,
+                constitutionArticles: allArticleIds,
+                presetId: presetId,
+            });
+            materialized.push({
+                agentId: agent.id,
+                count: result.commands.length,
+                paths: result.commands.map((c) => c.path),
+            });
+        }
+        catch (err) {
+            logger.warn(`Failed to materialize slash commands for ${agent.displayName}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    const amendmentsLog = join(raptorDir, "memory", "amendments.log");
+    const actor = currentActor("human");
+    appendAuditEvent(amendmentsLog, {
+        event: "constitution.initialized",
+        command: opts.auditCommand ?? "raptor init",
+        actor: { user: actor.user, via: actor.via },
+        outputs: [
+            { path: ".raptor/constitution.md", hash: hashString(constitution) },
+            { path: ".raptor/agents.yml", hash: hashString(agentsYamlContent) },
+        ],
+        meta: {
+            core_version: CORE_VERSION,
+            preset: presetLabel,
+            preset_version: preset?.version,
+            preset_articles: allArticleIds,
+            project: projectName,
+            detected_agents: installedAgents.map((a) => a.id),
+            configured_agents: targetAgents.map((a) => a.id),
+        },
+    });
+    const ciResult = opts.withCi
+        ? installCiWorkflow(cwd)
+        : { status: "disabled" };
+    const hooksResult = opts.withHooks
+        ? installGitHooks(cwd)
+        : { status: "disabled" };
+    return {
+        raptorDir,
+        projectName,
+        presets,
+        presetLabel,
+        allArticleIds,
+        primaryAgentId: primaryAgent?.id,
+        targetAgents,
+        materialized,
+        agentsYamlPath,
+        manifestPath,
+        ciResult,
+        hooksResult,
+    };
+}
+function installCiWorkflow(cwd) {
+    const dir = join(cwd, ".github", "workflows");
+    const path = join(dir, "raptor-verify.yml");
+    if (existsSync(path)) {
+        return { status: "skipped-existing", path };
+    }
+    mkdirSync(dir, { recursive: true });
+    const content = renderBundled("ghaWorkflow", { raptorVersion: VERSION });
+    writeFileSync(path, content);
+    return { status: "installed", path };
+}
+function installGitHooks(cwd) {
+    const gitDir = join(cwd, ".git");
+    if (!existsSync(gitDir)) {
+        return { status: "skipped-no-git" };
+    }
+    const hooksDir = join(gitDir, "hooks");
+    mkdirSync(hooksDir, { recursive: true });
+    const hooks = [
+        { name: "pre-commit", key: "preCommitHook" },
+        { name: "pre-push", key: "prePushHook" },
+        { name: "commit-msg", key: "commitMsgHook" },
+    ];
+    const installed = [];
+    const skipped = [];
+    for (const h of hooks) {
+        const path = join(hooksDir, h.name);
+        if (existsSync(path)) {
+            skipped.push(h.name);
+            continue;
+        }
+        const content = renderBundled(h.key, {});
+        writeFileSync(path, content);
+        chmodSync(path, 0o755);
+        installed.push(h.name);
+    }
+    return { status: "ok", installed, skipped };
+}
+export function describeCi(r) {
+    if (r.status === "disabled")
+        return "disabled (--no-with-ci)";
+    if (r.status === "skipped-existing")
+        return `skipped (${r.path} already exists)`;
+    return `installed at ${r.path}`;
+}
+export function describeHooks(r) {
+    if (r.status === "disabled")
+        return "disabled (--no-with-hooks)";
+    if (r.status === "skipped-no-git")
+        return "skipped (.git/ not found — run 'git init' first)";
+    const parts = [];
+    if (r.installed.length > 0)
+        parts.push(`installed: ${r.installed.join(", ")}`);
+    if (r.skipped.length > 0)
+        parts.push(`skipped (already exist): ${r.skipped.join(", ")}`);
+    return parts.length > 0 ? parts.join("; ") : "nothing to do";
+}

package/dist/shared/setup/agent-resolver.js

@@ -0,0 +1,54 @@
+export const IDES = [
+    { id: "vscode", label: "VS Code" },
+    { id: "cursor", label: "Cursor", hint: "IDE multi-modelo" },
+    { id: "antigravity", label: "Antigravity", hint: "IDE do Google · Gemini" },
+    { id: "jetbrains", label: "JetBrains" },
+    { id: "terminal", label: "Terminal / CLI" },
+    { id: "other", label: "Outro / manual" },
+];
+const AIS_BY_IDE = {
+    vscode: [
+        { id: "claude-code", label: "Claude Code", agentKey: "claude-code", hint: "→ CLAUDE.md" },
+        { id: "copilot", label: "GitHub Copilot", agentKey: "copilot", hint: "→ .github/copilot-instructions.md" },
+        { id: "gemini", label: "Gemini", agentKey: "gemini", hint: "→ GEMINI.md" },
+        { id: "codex", label: "OpenAI Codex", agentKey: "codex", hint: "→ AGENTS.md" },
+    ],
+    cursor: [
+        { id: "cursor", label: "Cursor", agentKey: "cursor", hint: "modelo gerenciado pelo Cursor → .cursor/rules/" },
+    ],
+    antigravity: [
+        { id: "gemini", label: "Gemini", agentKey: "antigravity", hint: "→ AGENTS.md" },
+    ],
+    jetbrains: [
+        { id: "claude-code", label: "Claude Code", agentKey: "claude-code", hint: "→ CLAUDE.md" },
+        { id: "copilot", label: "GitHub Copilot", agentKey: "copilot", hint: "→ .github/copilot-instructions.md" },
+    ],
+    terminal: [
+        { id: "claude-code", label: "Claude Code", agentKey: "claude-code", hint: "→ CLAUDE.md" },
+        { id: "gemini", label: "Gemini CLI", agentKey: "gemini", hint: "→ GEMINI.md" },
+        { id: "codex", label: "OpenAI Codex CLI", agentKey: "codex", hint: "→ AGENTS.md" },
+    ],
+    other: [
+        { id: "claude-code", label: "Claude Code", agentKey: "claude-code", hint: "→ CLAUDE.md" },
+        { id: "cursor", label: "Cursor", agentKey: "cursor", hint: "→ .cursor/rules/" },
+        { id: "copilot", label: "GitHub Copilot", agentKey: "copilot", hint: "→ .github/copilot-instructions.md" },
+        { id: "gemini", label: "Gemini", agentKey: "gemini", hint: "→ GEMINI.md" },
+        { id: "codex", label: "OpenAI Codex", agentKey: "codex", hint: "→ AGENTS.md" },
+    ],
+};
+export function isKnownIde(ide) {
+    return IDES.some((i) => i.id === ide);
+}
+export function aisForIde(ide) {
+    return AIS_BY_IDE[ide] ?? [];
+}
+export function resolveAgentKey(ide, ai) {
+    return aisForIde(ide).find((a) => a.id === ai)?.agentKey;
+}
+export function referencedAgentKeys() {
+    const keys = new Set();
+    for (const list of Object.values(AIS_BY_IDE))
+        for (const ai of list)
+            keys.add(ai.agentKey);
+    return [...keys];
+}

package/dist/shared/setup/banner.js

@@ -0,0 +1,19 @@
+import { bold, cyan, dim } from "../ui.js";
+const ASCII = [
+    "██████╗  █████╗ ██████╗ ████████╗ ██████╗ ██████╗",
+    "██╔══██╗██╔══██╗██╔══██╗╚══██╔══╝██╔═══██╗██╔══██╗",
+    "██████╔╝███████║██████╔╝   ██║   ██║   ██║██████╔╝",
+    "██╔══██╗██╔══██║██╔═══╝    ██║   ██║   ██║██╔══██╗",
+    "██║  ██║██║  ██║██║        ██║   ╚██████╔╝██║  ██║",
+    "╚═╝  ╚═╝╚═╝  ╚═╝╚═╝        ╚═╝    ╚═════╝ ╚═╝  ╚═╝",
+];
+const ASCII_WIDTH = Math.max(...ASCII.map((l) => l.length));
+export function renderBanner(version) {
+    const cols = process.stdout.columns ?? 80;
+    if (cols < ASCII_WIDTH + 2) {
+        return `${cyan(bold("▲ RAPTOR"))} ${dim(`· AIOS · SDD · v${version}`)}`;
+    }
+    const art = ASCII.map((line) => cyan(line)).join("\n");
+    const tag = `${bold("AIOS")} ${dim(`· Spec-Driven Development · v${version}`)}`;
+    return `${art}\n${tag}`;
+}

package/dist/shared/setup/detect-stack.js

@@ -0,0 +1,31 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+export function detectProjectStack(root) {
+    const pkgPath = join(root, "package.json");
+    const hasPackageJson = existsSync(pkgPath);
+    const hasGit = existsSync(join(root, ".git"));
+    let deps = {};
+    if (hasPackageJson) {
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+            deps = { ...pkg.dependencies, ...pkg.devDependencies };
+        }
+        catch {
+        }
+    }
+    const isReactNative = Boolean(deps["react-native"]);
+    const isWeb = Boolean(deps["react"]) && !isReactNative;
+    const language = existsSync(join(root, "tsconfig.json")) || Boolean(deps["typescript"])
+        ? "typescript"
+        : "javascript";
+    const suggestedPreset = isReactNative ? "mobile-opinionated" : undefined;
+    return {
+        hasPackageJson,
+        hasGit,
+        isReactNative,
+        isWeb,
+        language,
+        suggestedPreset,
+        isBrownfield: hasPackageJson,
+    };
+}

package/dist/shared/setup/onboard.js

@@ -0,0 +1,18 @@
+export const ONBOARD = [
+    "O RAPTOR transforma uma ideia em linguagem natural numa especificação",
+    "rica e sem pontas soltas — e conduz, fase a fase, até o código",
+    "verificado, sempre com um humano no comando das aprovações.",
+    "",
+    "Ele não escreve a spec nem o código sozinho: orquestra o ciclo, aplica",
+    "gates que bloqueiam transições incompletas, mantém uma trilha de",
+    "auditoria e materializa slash commands para o seu agente de IA.",
+    "",
+    "Diferencial — a ponta de verificação: o RAPTOR mede a realidade do app",
+    "(acessibilidade, performance, permissões de loja, versões de SO) e",
+    "compara com o que a spec prometeu.",
+    "",
+    "Ciclo:  new → specify → clarify → plan → tasks → implement → verify",
+].join("\n");
+export function renderOnboard() {
+    return ONBOARD;
+}

package/dist/shared/setup/plan.js

@@ -0,0 +1,93 @@
+import { performInit, } from "../init-core.js";
+import { readConfig, writeConfig } from "../project.js";
+import { resolveAgentKey } from "./agent-resolver.js";
+export function buildSetupPlan(answers, ctx) {
+    const primaryAgentKey = resolveAgentKey(answers.ide, answers.ai);
+    if (!primaryAgentKey) {
+        throw new Error(`Nenhuma integração de agente mapeia IDE "${answers.ide}" + IA "${answers.ai}".`);
+    }
+    return {
+        cwd: ctx.cwd,
+        projectName: answers.projectName,
+        preset: answers.preset,
+        primaryAgentKey,
+        startingPoint: answers.startingPoint,
+        noGit: false,
+        jiraLater: answers.jiraLater,
+        figmaLater: answers.figmaLater,
+        force: ctx.force,
+    };
+}
+function worthPreserving(block) {
+    return (!!block &&
+        typeof block === "object" &&
+        !Array.isArray(block) &&
+        (block.enabled === true || Object.keys(block).some((k) => k !== "enabled")));
+}
+export function applySetupPlan(plan, logger) {
+    const prior = readConfig(plan.cwd);
+    const priorJira = worthPreserving(prior.jira) ? prior.jira : undefined;
+    const priorDesign = worthPreserving(prior.design) ? prior.design : undefined;
+    const priorGit = prior.git;
+    const priorGates = prior.gates;
+    const init = performInit({
+        cwd: plan.cwd,
+        projectName: plan.projectName ?? prior.project?.name,
+        preset: plan.preset,
+        ai: plan.primaryAgentKey,
+        script: "sh",
+        branchNumbering: "sequential",
+        noGit: plan.noGit,
+        withCi: true,
+        withHooks: true,
+        force: plan.force,
+        auditCommand: "raptor setup",
+    }, logger);
+    const cfg = readConfig(plan.cwd);
+    let changed = false;
+    if (priorGit) {
+        cfg.git = { ...cfg.git, ...priorGit };
+        changed = true;
+    }
+    if (priorGates) {
+        cfg.gates = { ...cfg.gates, ...priorGates };
+        changed = true;
+    }
+    if (priorJira) {
+        cfg.jira = priorJira;
+        changed = true;
+    }
+    if (priorDesign) {
+        cfg.design = priorDesign;
+        changed = true;
+    }
+    let jiraConfigured = false;
+    let figmaConfigured = false;
+    if (plan.jiraLater && !cfg.jira?.enabled) {
+        cfg.jira = {
+            ...cfg.jira,
+            enabled: false,
+            provider: cfg.jira?.provider ?? "atlassian-oauth",
+        };
+        jiraConfigured = true;
+        changed = true;
+    }
+    if (plan.figmaLater && !cfg.design?.enabled) {
+        cfg.design = {
+            ...cfg.design,
+            enabled: false,
+            provider: cfg.design?.provider ?? "figma-rest",
+        };
+        figmaConfigured = true;
+        changed = true;
+    }
+    if (changed)
+        writeConfig(plan.cwd, cfg);
+    return {
+        init,
+        jiraConfigured,
+        figmaConfigured,
+        jiraPreserved: Boolean(priorJira),
+        figmaPreserved: Boolean(priorDesign),
+    };
+}

package/dist/shared/setup/wizard.js

@@ -0,0 +1,164 @@
+import * as p from "@clack/prompts";
+import { basename } from "node:path";
+import { knownPresetIds, VERSION } from "../../_core/dist/index.js";
+import { applySetupPlan, buildSetupPlan, } from "./plan.js";
+import { aisForIde, IDES } from "./agent-resolver.js";
+import { detectProjectStack } from "./detect-stack.js";
+import { renderBanner } from "./banner.js";
+import { renderOnboard } from "./onboard.js";
+import { describeCi, describeHooks, } from "../init-core.js";
+export async function runSetupWizard(ctx) {
+    console.log(`\n${renderBanner(VERSION)}\n`);
+    p.intro("Configuração guiada do projeto");
+    if (!ctx.skipIntro) {
+        const see = await p.confirm({
+            message: "Ver uma introdução rápida (30s) ao RAPTOR?",
+            initialValue: true,
+        });
+        if (p.isCancel(see))
+            return cancelled();
+        if (see)
+            p.note(renderOnboard(), "O que é o RAPTOR AIOS");
+    }
+    const stack = detectProjectStack(ctx.cwd);
+    const startingPoint = await p.select({
+        message: "Este projeto é...",
+        options: [
+            {
+                value: "existing",
+                label: "Já existente",
+                hint: stack.isBrownfield ? "código detectado aqui" : undefined,
+            },
+            { value: "scratch", label: "Do zero" },
+        ],
+        initialValue: stack.isBrownfield ? "existing" : "scratch",
+    });
+    if (p.isCancel(startingPoint))
+        return cancelled();
+    const ide = await p.select({
+        message: "Qual seu ambiente?",
+        options: IDES.map((i) => ({ value: i.id, label: i.label, hint: i.hint })),
+        initialValue: ctx.defaults?.ide,
+    });
+    if (p.isCancel(ide))
+        return cancelled();
+    const ais = aisForIde(ide);
+    let ai;
+    if (ais.length === 1) {
+        ai = ais[0].id;
+        p.log.info(`Assistente: ${ais[0].label}`);
+    }
+    else {
+        const picked = await p.select({
+            message: "Qual assistente de IA?",
+            options: ais.map((a) => ({ value: a.id, label: a.label, hint: a.hint })),
+            initialValue: ctx.defaults?.ai,
+        });
+        if (p.isCancel(picked))
+            return cancelled();
+        ai = picked;
+    }
+    const presetIds = knownPresetIds();
+    const suggested = stack.suggestedPreset ?? "mobile-opinionated";
+    const preset = await p.select({
+        message: "Preset da constituição",
+        options: presetIds.map((id) => ({
+            value: id,
+            label: id,
+            hint: id === suggested ? "sugerido para sua stack" : undefined,
+        })),
+        initialValue: ctx.defaults?.preset ?? suggested,
+    });
+    if (p.isCancel(preset))
+        return cancelled();
+    const jiraLater = await p.confirm({
+        message: "Deixar o Jira pronto para conectar depois?",
+        initialValue: ctx.defaults?.jiraLater ?? false,
+    });
+    if (p.isCancel(jiraLater))
+        return cancelled();
+    const figmaLater = await p.confirm({
+        message: "Deixar o Figma pronto para conectar depois?",
+        initialValue: ctx.defaults?.figmaLater ?? false,
+    });
+    if (p.isCancel(figmaLater))
+        return cancelled();
+    const answers = {
+        startingPoint,
+        projectName: ctx.defaults?.projectName,
+        ide,
+        ai,
+        preset,
+        jiraLater,
+        figmaLater,
+    };
+    let plan;
+    try {
+        plan = buildSetupPlan(answers, { cwd: ctx.cwd, force: ctx.force });
+    }
+    catch (err) {
+        p.cancel(err instanceof Error ? err.message : String(err));
+        return "failed";
+    }
+    p.note([
+        `Projeto:  ${plan.projectName ?? basename(ctx.cwd)}`,
+        `Preset:   ${plan.preset}`,
+        `Agente:   ${plan.primaryAgentKey}`,
+        `Jira:     ${plan.jiraLater ? "configurar depois" : "pular"}`,
+        `Figma:    ${plan.figmaLater ? "configurar depois" : "pular"}`,
+    ].join("\n"), "Revisão");
+    const go = await p.confirm({ message: "Aplicar agora?" });
+    if (p.isCancel(go))
+        return cancelled();
+    if (!go) {
+        p.outro("Nada foi alterado.");
+        return "declined";
+    }
+    const s = p.spinner();
+    s.start("Inicializando o projeto Raptor…");
+    const warnings = [];
+    const logger = {
+        log: () => { },
+        warn: (m) => warnings.push(typeof m === "string" ? m : String(m)),
+    };
+    let result;
+    try {
+        result = applySetupPlan(plan, logger);
+    }
+    catch (err) {
+        s.stop("Falhou.");
+        p.cancel(err instanceof Error ? err.message : String(err));
+        return "failed";
+    }
+    s.stop("Projeto inicializado.");
+    for (const w of warnings)
+        p.log.warn(w);
+    const matLine = result.init.materialized
+        .map((m) => `${m.agentId} (${m.count})`)
+        .join(", ") || "(nenhum)";
+    p.note([
+        `Comandos: ${matLine}`,
+        `CI:       ${describeCi(result.init.ciResult)}`,
+        `Hooks:    ${describeHooks(result.init.hooksResult)}`,
+        result.jiraPreserved
+            ? "Jira:     config existente preservada"
+            : result.jiraConfigured
+                ? "Jira:     pronto (raptor jira connect)"
+                : "",
+        result.figmaPreserved
+            ? "Figma:    config existente preservada"
+            : result.figmaConfigured
+                ? "Figma:    pronto (raptor design connect)"
+                : "",
+    ]
+        .filter(Boolean)
+        .join("\n"), "Pronto");
+    p.outro(plan.startingPoint === "existing"
+        ? "Próximo: 'raptor new <slug>' para especificar uma feature do código existente."
+        : "Próximo: 'raptor new <slug>' para criar sua primeira feature.");
+    return "completed";
+}
+function cancelled() {
+    p.cancel("Setup cancelado.");
+    return "cancelled";
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "raptor-aios",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "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": {
@@ -53,6 +53,7 @@
     "access": "public"
   },
   "dependencies": {
+    "@clack/prompts": "^1.5.1",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@oclif/core": "^4",
     "ajv": "^8.18.0",

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.11.0";
+const VERSION = "0.12.1";
 
 function log(msg) {
   process.stdout.write(`  ${msg}\n`);
@@ -177,6 +177,7 @@ const pkg = {
   bugs: { url: "https://github.com/lucaspedronet/raptor-aios/issues" },
   publishConfig: { access: "public" },
   dependencies: {
+    "@clack/prompts": "^1.5.1",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@oclif/core": "^4",
     ajv: "^8.18.0",