raptor-aios 0.13.0 → 0.13.2

package/CHANGELOG.md

@@ -5,7 +5,35 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
-## [0.13.0] - 2026-06-18
+## [0.13.2] - 2026-06-19
+
+### Fixed
+
+- **Specs semeadas do Jira não vêm mais com `\*\*lixo\*\*` de escape.** Servidores
+  MCP que retornam Markdown como string (notavelmente `mcp-atlassian`, via
+  markdownify) **escapam** a pontuação inline (`\*`, `\_`, `` \` ``, `\~`) ao
+  converter o wiki/ADF do Jira para Markdown, para mantê-la literal. O
+  `flattenAdf` repassava essa string sem desescapar, então o negrito do card
+  (`**Como**`) chegava na spec como `\*\*Como\*\*` visível — ruído em toda a spec
+  (127 linhas afetadas num card real). Agora `flattenAdf` desescapa a pontuação
+  markdown inline na sua branch de string (`unescapeInlineMarkdown`); o ADF
+  estruturado é texto cru e permanece intocado.
+
+### Fixed
+
+- **`raptor new` agora empilha as specs de verdade — auto-commit da spec na sua
+  branch.** O empilhamento de branches (v0.13.0) dependia de a spec anterior estar
+  **commitada** antes da próxima `raptor new`, mas havia um impasse: o `new` deixava
+  a spec *untracked* e o pre-commit hook **bloqueava** commitá-la manualmente (a spec
+  recém-criada falha nos gates M1–M5, que valem para uma feature já preenchida). Sem
+  commit, a árvore ficava suja, o guard pulava a criação da próxima branch e o
+  empilhamento nunca acontecia — a nova spec não herdava as anteriores. Agora o `new`
+  **commita automaticamente** a spec scaffolded na sua branch de feature (escopo
+  restrito a `.raptor/specs/<NNN-slug>`, sem varrer outras mudanças; `--no-verify`
+  porque os gates não se aplicam a um scaffold). A árvore fica limpa, a próxima
+  `raptor new` forka de uma base commitada e **cada branch carrega todas as specs
+  anteriores** — preservando dependências entre specs. Use `--no-commit` para
+  desativar. Novo helper `commitPaths` em `@raptor/core`.
 
 ### Fixed
 
@@ -38,6 +66,13 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
   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).
 
+### Docs
+
+- **Novo:** [`docs/feature-branching-and-numbering.md`](docs/feature-branching-and-numbering.md)
+  documenta o diagnóstico completo do falso "o `new` sobrescreve a spec anterior" (resolução
+  por sufixo + branch forkando da `main` + casca vazia ao trocar de branch) e o modelo de
+  branches empilhadas / numeração por união a partir desta release.
+
 ## [0.12.2] - 2026-06-16
 
 ### 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-1356%20passing-22c55e)](#️-desenvolvimento-local)
-[![version](https://img.shields.io/badge/version-0.12.2-ef4444)](CHANGELOG.md)
+[![tests](https://img.shields.io/badge/tests-1374%20passing-22c55e)](#️-desenvolvimento-local)
+[![version](https://img.shields.io/badge/version-0.13.0-ef4444)](CHANGELOG.md)
 [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
 </div>
@@ -621,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     # ~1356 testes (1071 core + ~251 cli + 34 e2e)
+pnpm -r test && pnpm test:e2e     # ~1374 testes (1071 core + 258 cli + 45 e2e)
 
 # usar a CLI local em outro projeto:
 cd packages/cli && npm link        # ou: pnpm link --global

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

@@ -56,3 +56,17 @@ export function stagedFiles(exec, cwd) {
         .map((s) => s.trim())
         .filter(Boolean);
 }
+export function commitPaths(exec, cwd, paths, message) {
+    if (paths.length === 0)
+        return { status: 0, committed: false };
+    const status = exec(["status", "--porcelain", "--", ...paths], { cwd });
+    if (status.status !== 0)
+        return { status: status.status, committed: false };
+    if (status.stdout.trim() === "")
+        return { status: 0, committed: false };
+    const add = exec(["add", "--", ...paths], { cwd });
+    if (add.status !== 0)
+        return { status: add.status, committed: false };
+    const commit = exec(["commit", "--no-verify", "-m", message, "--", ...paths], { cwd });
+    return { status: commit.status, committed: commit.status === 0 };
+}

package/dist/_core/dist/jira/mapper.js

@@ -269,11 +269,15 @@ export function mapIssueToSpecContext(issue, opts = {}) {
         jiraCustomSections: sections,
     };
 }
+const MD_INLINE_ESCAPE = /\\([*_`~])/g;
+export function unescapeInlineMarkdown(s) {
+    return s.replace(MD_INLINE_ESCAPE, "$1");
+}
 export function flattenAdf(node) {
     if (node == null)
         return "";
     if (typeof node === "string")
-        return node.trim();
+        return unescapeInlineMarkdown(node.trim());
     if (Array.isArray(node))
         return node.map(flattenAdf).join("");
     if (!isRecord(node))

package/dist/_core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raptor/core",
-  "version": "0.13.0",
+  "version": "0.13.2",
   "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, execSyncGitExecutor, executeWorkflow, listBranches, extractFigmaRefs, hashString, inferKindFromJiraIssueType, loadAgentsConfig, mapDesignToSpecContext, mapIssueToSpecContext, parseFrontmatter, renderBundled, selectAgent, writeDesignScaffold, } from "../_core/dist/index.js";
+import { appendAuditEvent, buildCanonicalPrompt, commitPaths, deriveBranchName, execSyncGitExecutor, executeWorkflow, isGitRepo, 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";
@@ -67,6 +67,11 @@ export default class New extends BaseCommand {
             description: "Skip automatic branch creation even when git.branch_per_feature is enabled",
             default: false,
         }),
+        commit: Flags.boolean({
+            description: "Auto-commit the scaffolded spec on its feature branch (bypasses the pre-commit hook so the tree stays clean and the next `raptor new` stacks the next spec on top). Use --no-commit to leave the spec uncommitted.",
+            allowNo: true,
+            default: true,
+        }),
         "non-interactive": Flags.boolean({
             description: "Never prompt; on a dirty work tree, skip branch creation instead of asking",
             default: false,
@@ -379,6 +384,12 @@ export default class New extends BaseCommand {
         else if (branchResult?.outcome === "already") {
             this.log(`  Branch:    ${branchResult.branch} (already checked out)`);
         }
+        this.maybeAutoCommitSpec({
+            root,
+            featureName,
+            branchResult,
+            doCommit: flags.commit,
+        });
         this.log("");
         if (flags["wait-artifact"] && agentInfo.commandFile) {
             await waitForPhaseArtifact({
@@ -481,6 +492,22 @@ export default class New extends BaseCommand {
             interactive: resolveInteractive(ctx.nonInteractive),
         });
     }
+    maybeAutoCommitSpec(ctx) {
+        if (!ctx.doCommit)
+            return;
+        if (!ctx.branchResult || ctx.branchResult.outcome === "skipped")
+            return;
+        if (!isGitRepo(execSyncGitExecutor, ctx.root))
+            return;
+        const rel = join(".raptor", "specs", ctx.featureName);
+        const res = commitPaths(execSyncGitExecutor, ctx.root, [rel], `chore: scaffold spec ${ctx.featureName}`);
+        if (res.committed) {
+            this.log(`  Committed: ${rel} (spec sealed on ${ctx.branchResult.branch} — next \`raptor new\` will stack on top)`);
+        }
+        else if (res.status !== 0) {
+            this.warn(`Auto-commit of the spec failed (git exit ${res.status}). Spec is saved; commit it manually so the next \`raptor new\` stacks.`);
+        }
+    }
     async fetchJiraContext(root, key) {
         const conn = jiraConn(readConfig(root));
         if (!conn) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "raptor-aios",
-  "version": "0.13.0",
+  "version": "0.13.2",
   "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.13.0";
+const VERSION = "0.13.2";
 
 function log(msg) {
   process.stdout.write(`  ${msg}\n`);

package/dist/_core/dist/agents/materialize.js

@@ -1,156 +0,0 @@
-/**
- * Cross-Agent Materialization Pipeline — Materializes slash commands
- * for all registered agents.
- *
- * Given a canonical prompt (agent-neutral), this pipeline:
- *   1. Resolves placeholders (renderer)
- *   2. Packs the prompt for each agent (adapter.packPrompt)
- *   3. Writes command files to the agent's expected location
- *
- * Spec Kit ref: E11 — "Pipeline de materialização cross-agent"
- */
-import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
-import { join, basename } from "node:path";
-import { listAgents, getAgent } from "../agents/registry.js";
-import { renderPrompt, autoResolveContext } from "../prompts/renderer.js";
-// ---------------------------------------------------------------------------
-// Pipeline
-// ---------------------------------------------------------------------------
-/**
- * Materialize all canonical prompts for the specified agents.
- *
- * Reads templates from `templates/commands/` and extension `commands/`,
- * renders them, packs them for each agent, and writes output files.
- */
-export function materializeAllCommands(options) {
-    const results = [];
-    const ctx = autoResolveContext(options.projectRoot, options.context);
-    // Determine target agents
-    const registeredAgents = listAgents();
-    const targetIds = options.agentIds ?? registeredAgents.map((a) => a.id);
-    // Collect prompt templates
-    const templates = collectPromptTemplates(options.projectRoot);
-    for (const agentId of targetIds) {
-        const adapter = getAgent(agentId);
-        if (!adapter) {
-            results.push({
-                agentId,
-                commandName: "*",
-                outputPath: "",
-                written: false,
-                error: `Agent '${agentId}' not registered`,
-            });
-            continue;
-        }
-        for (const { name, content } of templates) {
-            const result = materializeSingleCommand(options.projectRoot, adapter, name, content, ctx, options.dryRun);
-            results.push(result);
-        }
-    }
-    return results;
-}
-/**
- * Materialize a single command for a specific agent.
- */
-function materializeSingleCommand(projectRoot, adapter, commandName, templateContent, ctx, dryRun) {
-    const agentId = adapter.id;
-    try {
-        // 1. Render placeholders
-        const rendered = renderPrompt(templateContent, ctx);
-        // 2. Pack for agent (converts to agent-specific format)
-        // We construct a mock CanonicalPrompt because static slash commands
-        // don't have dynamic feature context yet (handled at runtime).
-        const canonical = {
-            command: commandName,
-            feature: adapter.argumentSyntax, // e.g. "$ARGUMENTS"
-            promptHash: "static-template",
-            generatedAt: new Date().toISOString(),
-            body: rendered,
-            scope: { read: [], write: [], forbidden: [] },
-            invariants: [],
-            inputs: [],
-            expectedOutput: "",
-            outputSchema: "",
-            articles: [],
-        };
-        const packed = adapter.packPrompt(canonical);
-        // 3. Determine output path
-        const outputDir = resolveOutputDir(projectRoot, adapter);
-        const fileName = adapter.commandFileName(`rpt.${commandName}`);
-        const outputPath = join(outputDir, fileName);
-        // 4. Write
-        if (!dryRun) {
-            if (!existsSync(outputDir)) {
-                mkdirSync(outputDir, { recursive: true });
-            }
-            writeFileSync(outputPath, packed);
-        }
-        return {
-            agentId,
-            commandName,
-            outputPath,
-            written: !dryRun,
-        };
-    }
-    catch (err) {
-        return {
-            agentId,
-            commandName,
-            outputPath: "",
-            written: false,
-            error: err.message,
-        };
-    }
-}
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-/**
- * Collect all prompt templates from the project.
- */
-function collectPromptTemplates(projectRoot) {
-    const templates = [];
-    // Core prompts
-    const coreDir = join(projectRoot, "templates", "commands");
-    if (existsSync(coreDir)) {
-        for (const file of readdirSync(coreDir)) {
-            if (!file.endsWith(".md"))
-                continue;
-            const name = basename(file, ".md");
-            const content = readFileSync(join(coreDir, file), "utf-8");
-            templates.push({ name, content });
-        }
-    }
-    // Extension prompts
-    const extDir = join(projectRoot, "extensions");
-    if (existsSync(extDir)) {
-        for (const ext of readdirSync(extDir)) {
-            const cmdDir = join(extDir, ext, "commands");
-            if (!existsSync(cmdDir))
-                continue;
-            for (const file of readdirSync(cmdDir)) {
-                if (!file.endsWith(".md"))
-                    continue;
-                const name = basename(file, ".md");
-                const content = readFileSync(join(cmdDir, file), "utf-8");
-                templates.push({ name, content });
-            }
-        }
-    }
-    return templates;
-}
-/**
- * Resolve the output directory for an agent's command files.
- */
-function resolveOutputDir(projectRoot, adapter) {
-    // Agent-specific directories
-    const agentDirMap = {
-        "claude-code": ".claude/commands",
-        "cursor": ".cursor/commands",
-        "antigravity": ".gemini/commands",
-        "gemini": ".gemini/commands",
-        "human": ".raptor/commands",
-    };
-    const dir = agentDirMap[adapter.id] ?? `.raptor/agents/${adapter.id}/commands`;
-    return join(projectRoot, dir);
-}