raptor-aios 0.8.0 → 0.8.3

package/CHANGELOG.md

@@ -3,6 +3,45 @@
 All notable changes to this project will be documented in this file.
 Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.8.3] - 2026-06-10
+
+### Documentation
+
+- **Glossário Canônico (`docs/glossary.md`) reescrito e certificado contra o código.** Passou de ~16 termos para ~60 conceitos cobrindo todo o ecossistema (Gate, GateLevel, ADR, Override, Canonical, Blueprint, Priority Stack, Preset, Extension, Hook, Skill, MCP, Harness, SDD, Stage, Workflow, Traceability/Coverage/Trace, Staleness, Readiness, M1–M6/M7/M8, C1–C5, D#, artefatos e memória), cada um no modelo Nome/Objetivo/Definição/Responsabilidades/Quando usar/Quando não usar/Relação/Prioridade/Exemplos/Anti-padrões. Inclui apêndices com as hierarquias de governança/decisão/documentos/execução/contexto, a distinção C/D/M, o catálogo dos 42 gates (nível + artigo) e o catálogo de comandos CLI. Cada entrada cita `arquivo:linha`.
+- **README atualizado para refletir o código atual.** Nova seção "Documentação & glossário" (com link em destaque para o glossário, tabela dos docs e diagrama mermaid da hierarquia de governança) e entrada no índice. Correções confrontadas com `packages/core`/`packages/cli`: contagem de testes (1019 = 784 core + 201 cli + 34 e2e), workflows bundled (`sdd-cycle`, `sdd-cycle-quick`), hooks (34 pontos = before/after de 17 comandos), tabelas "Capacidades" e "Referência CLI" com markdown corrigido, badge de versão, e menção ao preset `lean`.
+
+## [0.8.2] - 2026-06-10
+
+### Fixed
+
+- **`raptor preset add` no longer silently disables the preset's gates (A1).** The command writes the `presets:` array and removes the singular `preset:`, but every gate consumer (`verify`, `plan`, `gate skip/approve/list`, `doctor`, `status`) read only `config.preset` — so after `preset add` the mobile M1–M6 gates stopped running with no warning. A single resolver `resolveActivePresets` (`packages/cli/src/shared/presets.ts`) now reads both shapes via `activePresetIds` and stacks the resolved presets (`stackPresets`), so the array path yields the same gates and multiple presets compose. Unknown (e.g. disk-based) ids surface as an honest warning instead of being dropped.
+- **M7 acceptance coverage now works from each task's `[AC-#]` tags, not a broken heuristic (A2).** The M7 gates derived coverage with `t.story.replace(/^US-/, "A")` → `A1`, while specs use `AC-1`; the fallback never matched, so `gate.m7.acceptance_has_coverage` failed spuriously whenever the impl-log lacked explicit `traces_acceptance`, and `gate.m7.coverage_evidence_valid` went inert. `parseTaskList` now captures `acceptance[]` from each task's `[AC-#]` tags, and a new `buildTaskAcceptanceMap` feeds the coverage projection. Explicit `traces_acceptance` still wins.
+
+### Changed
+
+- **`raptor verify` now runs the clarify/analyze/checklist phase gates (A3).** `WIRED_PHASE_GATES` (a 6-gate subset of `PHASE_GATES`) is wired into `BUILTIN_GATES`. Guards keep this from breaking existing flows: `gate.clarify.acceptance_still_covered` now skips draft specs (only bites after approval, like the readiness gates), the redundant `gate.clarify.no_contradictions` is excluded (already covered by `gate.spec.clarifications`), and the checklist gates only validate structured CK checklists (those with frontmatter) — the `/rpt.checklist`-generated free-prose `requirements.md` is skipped, not failed.
+
+### Removed
+
+- **Dropped the orphaned `templates/checklist-template.md`.** It was a generic, backend-flavoured "Quality Checklist" (endpoints, N+1 queries, pagination, OWASP, connection pools…) misaligned with Raptor's mobile/React Native focus, and nothing consumed it: it isn't a bundled `.hbs` template, `raptor checklist --init` generates its own structured `CK-#` checklist, and `/rpt.checklist` carries its categories inline (writing `checklists/requirements.md`). Removing it cuts dead, off-tone duplication without changing any live behaviour (`installTemplates` copies `*-template.md` by glob; the suite stays green).
+
+### Internal
+
+- New `resolveActivePresets` (cli), `buildTaskAcceptanceMap` + `TaskItem.acceptance` (core), `WIRED_PHASE_GATES` (core) — all unit-tested. Suite: core 784, cli 201, e2e 34 — all green. Verified end-to-end on a scratch project (`preset add` keeps the mobile gates active; a prose `requirements.md` is skipped, not failed).
+
+## [0.8.1] - 2026-06-09
+
+### Fixed
+
+- **`raptor jira pull` / `new --jira` against a self-hosted MCP server now work without a `dialect:` and fail clearly when misconfigured.** Three silent failures in the MCP connect path are fixed:
+  - **Dialect auto-detection** — a `jira.mcp` block without `dialect:` used to default to the hosted Rovo dialect, so a snake-case `mcp-atlassian` server received the camelCase `getJiraIssue` and rejected it with an opaque *"Unknown tool: getJiraIssue"*. The client now infers the dialect from the tools the server advertises (`detectDialect`); an explicit `dialect:` still wins.
+  - **Fail-loud tool resolution** — when no advertised tool matches an operation, the client throws an actionable error (naming the op, the dialect and the advertised tools, pointing at `jira.mcp.dialect`) instead of sending a bogus name.
+  - **Empty-env warning** — `connectMcpServer` now warns (via `missingEnvRefs`) when a `${VAR}` reference without a default resolves to unset/empty, so a missing or misnamed token surfaces at connect time instead of as the server's opaque *"Jira configuration could not be resolved"*.
+
+### Internal
+
+- New `detectDialect` (dialects) and `missingEnvRefs` (mcp-client), both exported and unit-tested. Verified end-to-end against the real KAN-2 card: a dialect-less config pulls successfully, and a missing token prints the warning.
+
 ## [0.8.0] - 2026-06-09
 
 ### Added

package/README.md

@@ -7,7 +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-881%20passing-22c55e)](#-desenvolvimento-local)
+[![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)
 [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
 </div>
@@ -42,6 +43,7 @@ raptor new login-biometrico -d "Permitir login com Face ID / digital"
 - [🧰 Capacidades do Raptor](#-capacidades-do-raptor)
 - [📖 Referência de comandos CLI](#-referência-de-comandos-cli)
 - [🗂️ Estrutura criada no projeto](#️-estrutura-criada-no-projeto)
+- [📚 Documentação & glossário](#-documentação--glossário)
 - [🛠️ Desenvolvimento local](#️-desenvolvimento-local)
 - [⚖️ Governança & contribuição](#️-governança--contribuição)
 
@@ -420,6 +422,7 @@ observability:
 </details>
 
 > 🧯 **Feature sem APIs restritas?** Não invente permissões. Há dois caminhos honestos e auditáveis para o M1:
+>
 > 1. **Opt-out no spec** — deixe as listas vazias e declare `stores.no_restricted_apis: "<motivo>"` (espelha `a11y.wcag_level: "n/a"` e `perf_budget.scope: "none"`).
 > 2. **Override por ADR** — registre um ADR aceito em `.raptor/memory/decisions.md` com `Overrides: gate.mobile.stores`; o `verify` o lê em runtime e marca o gate como `⊝ overridden by ADR-NNN`. Gates **críticos** nunca são waivados por ADR (exigem assinatura humana).
 >
@@ -451,17 +454,17 @@ Declarar não é cumprir. O Raptor **mede** e compara com o declarado:
 
 ## 🧰 Capacidades do Raptor
 
-|       Capacidade        |                                        Para que serve                                        |                 Comandos                  |                        |         |             |
-| ----------------------- | -------------------------------------------------------------------------------------------- | ----------------------------------------- | ---------------------- | ------- | ----------- |
-| 🎚️ **Presets**          | Conjuntos reusáveis de artigos + gates, empilháveis. Bundled: `mobile-opinionated`.          | `raptor preset list\                      | add\                   | info\   | remove`     |
-| 🔁 **Workflows**         | Orquestram o ciclo via YAML, com gates de revisão humana. Bundled: `sdd-cycle`, `quick-fix`. | `raptor workflow catalog\                 | run\                   | status\ | resume`     |
-| 🤖 **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`     |
-| 🔌 **MCP**               | Registra servidores MCP e materializa nas configs nativas dos agentes.                       | `raptor mcp add\                          | list\                  | sync\   | remove`     |
-| 🪝 **Hooks**             | Scripts disparados em ~20 pontos do ciclo (`before_*`/`after_*`).                            | `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` |
-| 📜 **Auditoria & trace** | Consulta a trilha de eventos e a rastreabilidade.                                            | `raptor audit query\                      | show` · `raptor trace` |         |             |
+|       Capacidade        |                                        Para que serve                                         |                       Comandos                        |
+| ----------------------- | --------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
+| 🎚️ **Presets**          | Conjuntos reusáveis de artigos + gates, empilháveis. Bundled: `mobile-opinionated`, `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`             |
+| 🔌 **MCP**               | Registra servidores MCP e materializa nas configs nativas dos agentes.                        | `raptor mcp add · list · sync · remove`               |
+| 🪝 **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`    |
+| 📜 **Auditoria & trace** | Consulta a trilha de eventos e a rastreabilidade.                                             | `raptor audit query · show` · `raptor trace`          |
 
 ### 🎟️ Integração com Jira
 
@@ -478,15 +481,15 @@ 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         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
-| 📊 Status       status · doctor · trace · audit query | show    |                                                        |
-| ⚖️ Governança   gate list                            | approve | 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
+🔬 Verificação   verify · verify a11y · verify perf · verify stores · verify os-matrix
+                 verify architecture · verify audit · verify constitution
+📊 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
 ```
 
 Rode `raptor <comando> --help` para os detalhes (flags, exemplos) de cada um.
@@ -547,6 +550,43 @@ CLAUDE.md                    # 📎 bloco de contexto do agente
 
 ---
 
+## 📚 Documentação & glossário
+
+Comece pelo **[📖 Glossário Canônico](docs/glossary.md)** — a referência normativa de todos os termos, gates, hierarquias e anti-padrões do Raptor (Gate, ADR, Override, Canonical, Preset, M1–M8, C1–C5, traceability…). É a base de onboarding para usuários, mantenedores e agentes IA.
+
+| Documento | Sobre |
+| --- | --- |
+| **[📖 docs/glossary.md](docs/glossary.md)** | Glossário canônico: conceitos, hierarquias, catálogo de 42 gates e de comandos CLI |
+| [🛡️ 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 |
+| [🎟️ docs/jira-spec-enrichment.md](docs/jira-spec-enrichment.md) | Enriquecimento de spec a partir de cards do Jira |
+| [📐 docs/templates-architecture.md](docs/templates-architecture.md) | Dualidade de templates (`.hbs` vs `*-template.md`) e Priority Stack |
+| [✅ docs/spec-kit-parity.md](docs/spec-kit-parity.md) | Paridade com o GitHub Spec Kit |
+
+### Hierarquia de governança (quem manda)
+
+```mermaid
+flowchart TD
+    A["🧭 Constitution — Artigos C1–C5<br/><i>inviolável; só major release altera o core</i>"]
+    B["🔎 Phase -1 / Constitution Check<br/><i>confronta decisões com a constituição</i>"]
+    C["🛡️ Gates — 🔴 critical &gt; 🟡 required &gt; 🔵 advisory"]
+    D["📝 ADR / Override<br/><i>dispensa required/advisory; nunca critical</i>"]
+    E["👤 Human Review (C5)<br/><i>veto humano nos críticos</i>"]
+    A --> B --> C --> D --> E
+
+    classDef law fill:#fee2e2,stroke:#ef4444,color:#7f1d1d;
+    classDef enf fill:#fef9c3,stroke:#eab308,color:#713f12;
+    classDef human fill:#dcfce7,stroke:#22c55e,color:#14532d;
+    class A,B law;
+    class C,D enf;
+    class E human;
+```
+
+> Customização sem fork segue a **Priority Stack**: `overrides do projeto → presets → extensions → core`. Detalhes e justificativa de cada nível no [glossário](docs/glossary.md#hierarquias).
+
+---
+
 ## 🛠️ Desenvolvimento local
 
 Monorepo pnpm (`packages/core` = `@raptor/core`, `packages/cli` = binário `raptor`).
@@ -554,7 +594,7 @@ Monorepo pnpm (`packages/core` = `@raptor/core`, `packages/cli` = binário `rapt
 ```bash
 pnpm install
 pnpm build
-pnpm -r test && pnpm test:e2e     # 881 testes (674 core + 183 cli + 24 e2e)
+pnpm -r test && pnpm test:e2e     # 1019 testes (784 core + 201 cli + 34 e2e)
 
 # usar a CLI local em outro projeto:
 cd packages/cli && npm link        # ou: pnpm link --global

package/dist/_core/dist/gates/builtin.js

@@ -1119,6 +1119,7 @@ export const gateHotfixUnreconciled = {
 };
 import { M7_GATES } from "./m7-gates.js";
 import { DESIGN_GATES } from "./design-gates.js";
+import { WIRED_PHASE_GATES } from "./phase-gates.js";
 export const PROJECT_GATES = [
     gateConstitutionIntegrity,
     gateAmendmentCore,
@@ -1144,6 +1145,7 @@ export const BUILTIN_GATES = [
     gateTasksReady,
     ...M7_GATES,
     ...DESIGN_GATES,
+    ...WIRED_PHASE_GATES,
 ];
 export function gateById(id) {
     return BUILTIN_GATES.find((g) => g.id === id);

package/dist/_core/dist/gates/m7-gates.js

@@ -2,7 +2,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { parseImplLog, computeAcceptanceCoverage, } from "../models/impl-log.js";
 import { parseSpec } from "../models/spec.js";
-import { parseTasks, parseTaskList } from "../models/tasks.js";
+import { parseTasks, parseTaskList, buildTaskAcceptanceMap } from "../models/tasks.js";
 import { parseFrontmatter } from "../frontmatter/index.js";
 import { hashFile } from "../audit/hash.js";
 function result(gate, status, message) {
@@ -64,13 +64,7 @@ export const gateM7AcceptanceHasCoverage = {
         if (acceptanceIds.length === 0)
             return result(this, "pass", "No acceptance criteria to cover.");
         const taskList = tasks ? parseTaskList(tasks.body) : [];
-        const taskToAcceptance = {};
-        for (const t of taskList) {
-            if (t.story) {
-                const aId = t.story.replace(/^US-/, "A").replace(/^US/, "A");
-                taskToAcceptance[t.id] = [aId];
-            }
-        }
+        const taskToAcceptance = buildTaskAcceptanceMap(taskList);
         const coverage = computeAcceptanceCoverage(acceptanceIds, taskToAcceptance, implLog);
         const missing = acceptanceIds.filter((id) => coverage[id].length === 0);
         if (missing.length > 0) {
@@ -134,13 +128,7 @@ export const gateM7CoverageEvidenceValid = {
         if (acceptanceIds.length === 0)
             return result(this, "pass", "No acceptance criteria to validate.");
         const taskList = tasks ? parseTaskList(tasks.body) : [];
-        const taskToAcceptance = {};
-        for (const t of taskList) {
-            if (t.story) {
-                const aId = t.story.replace(/^US-?/, "A");
-                taskToAcceptance[t.id] = [aId];
-            }
-        }
+        const taskToAcceptance = buildTaskAcceptanceMap(taskList);
         const coverage = computeAcceptanceCoverage(acceptanceIds, taskToAcceptance, implLog);
         const errors = [];
         for (const aId of acceptanceIds) {

package/dist/_core/dist/gates/phase-gates.js

@@ -50,6 +50,9 @@ export const gateClarifyAcceptanceCovered = {
         }
         const raw = readFileSync(specPath, "utf8");
         const { data } = parseFrontmatter(raw);
+        if (data?.status !== "approved") {
+            return result(this, "skipped", "spec not yet approved; acceptance set is finalised at approval.");
+        }
         const acceptanceIds = data?.acceptance?.ids ?? [];
         if (acceptanceIds.length === 0) {
             return result(this, "fail", "No acceptance criteria IDs found in spec.md frontmatter after clarify.");
@@ -76,10 +79,14 @@ export const gateChecklistFrontmatter = {
             return result(this, "skipped", "No checklists found; skipping.");
         }
         const errors = [];
+        let validated = 0;
         for (const { kind, path } of checklists) {
             try {
                 const raw = readFileSync(path, "utf8");
-                const { data } = parseFrontmatter(raw);
+                const { data, hasFrontmatter } = parseFrontmatter(raw);
+                if (!hasFrontmatter)
+                    continue;
+                validated++;
                 if (!data.id)
                     errors.push(`${kind}.md: missing 'id' in frontmatter`);
                 if (!data.kind)
@@ -92,7 +99,10 @@ export const gateChecklistFrontmatter = {
         if (errors.length > 0) {
             return result(this, "fail", `Checklist frontmatter errors:\n  ${errors.join("\n  ")}`);
         }
-        return result(this, "pass", `${checklists.length} checklist(s) have valid frontmatter.`);
+        if (validated === 0) {
+            return result(this, "skipped", "No structured checklists (with frontmatter) found; skipping.");
+        }
+        return result(this, "pass", `${validated} checklist(s) have valid frontmatter.`);
     },
 };
 export const gateChecklistLinksToDecisions = {
@@ -112,7 +122,9 @@ export const gateChecklistLinksToDecisions = {
         let totalItems = 0;
         for (const { kind, path } of checklists) {
             const raw = readFileSync(path, "utf8");
-            const { body } = parseFrontmatter(raw);
+            const { body, hasFrontmatter } = parseFrontmatter(raw);
+            if (!hasFrontmatter)
+                continue;
             const items = parseChecklistItems(body);
             totalItems += items.length;
             for (const item of items) {
@@ -141,9 +153,13 @@ export const gateChecklistNonEmpty = {
             return result(this, "skipped", "No checklists found; skipping.");
         }
         const empty = [];
+        let structured = 0;
         for (const { kind, path } of checklists) {
             const raw = readFileSync(path, "utf8");
-            const { body } = parseFrontmatter(raw);
+            const { body, hasFrontmatter } = parseFrontmatter(raw);
+            if (!hasFrontmatter)
+                continue;
+            structured++;
             const items = parseChecklistItems(body);
             if (items.length === 0) {
                 empty.push(kind);
@@ -152,7 +168,10 @@ export const gateChecklistNonEmpty = {
         if (empty.length > 0) {
             return result(this, "fail", `Empty checklist(s): ${empty.join(", ")}`);
         }
-        return result(this, "pass", `All ${checklists.length} checklist(s) have items.`);
+        if (structured === 0) {
+            return result(this, "skipped", "No structured checklists found; skipping.");
+        }
+        return result(this, "pass", `All ${structured} checklist(s) have items.`);
     },
 };
 export const gateAnalyzeFrontmatter = {
@@ -235,3 +254,11 @@ export const PHASE_GATES = [
     gateAnalyzeFrontmatter,
     gateAnalyzeFindingsTraced,
 ];
+export const WIRED_PHASE_GATES = [
+    gateClarifyAcceptanceCovered,
+    gateChecklistFrontmatter,
+    gateChecklistLinksToDecisions,
+    gateChecklistNonEmpty,
+    gateAnalyzeFrontmatter,
+    gateAnalyzeFindingsTraced,
+];

package/dist/_core/dist/jira/dialects.js

@@ -82,3 +82,10 @@ export const DIALECTS = {
 export function resolveDialect(name) {
     return (name && DIALECTS[name]) || ROVO_DIALECT;
 }
+export function detectDialect(toolNames) {
+    for (const d of [MCP_ATLASSIAN_DIALECT, ROVO_DIALECT]) {
+        if (d.toolNames.getIssue.some((n) => toolNames.includes(n)))
+            return d;
+    }
+    return undefined;
+}

package/dist/_core/dist/jira/index.js

@@ -1,6 +1,6 @@
 export * from "./types.js";
 export * from "./credentials.js";
 export { AtlassianOAuthProvider, isAccessTokenExpired, openBrowser, startCallbackServer, } from "./oauth.js";
-export { connectJira, connectMcpServer, makeJiraClient, clientToToolCaller, decodeToolResult, unwrapEnvelope, expandEnv, } from "./mcp-client.js";
-export { ROVO_DIALECT, MCP_ATLASSIAN_DIALECT, DIALECTS, resolveDialect, } from "./dialects.js";
+export { connectJira, connectMcpServer, makeJiraClient, clientToToolCaller, decodeToolResult, unwrapEnvelope, expandEnv, missingEnvRefs, } from "./mcp-client.js";
+export { ROVO_DIALECT, MCP_ATLASSIAN_DIALECT, DIALECTS, resolveDialect, detectDialect, } from "./dialects.js";
 export { parseJiraIssue, parseCreatedIssue, extractComments, extractCustomFields, classifyField, flattenFieldValue, mapIssueToSpecContext, flattenAdf, extractAcceptanceCriteria, } from "./mapper.js";

package/dist/_core/dist/jira/mcp-client.js

@@ -4,14 +4,20 @@ import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js"
 import { UnauthorizedError } from "@modelcontextprotocol/sdk/client/auth.js";
 import { AtlassianOAuthProvider, openBrowser, startCallbackServer, } from "./oauth.js";
 import { mapIssueToSpecContext, parseCreatedIssue, parseJiraIssue, } from "./mapper.js";
-import { ROVO_DIALECT, resolveDialect, } from "./dialects.js";
+import { ROVO_DIALECT, resolveDialect, detectDialect, } from "./dialects.js";
 import { ATLASSIAN_MCP_URL, } from "./types.js";
 export function makeJiraClient(caller, opts = {}) {
-    const dialect = opts.dialect ?? ROVO_DIALECT;
+    const dialect = opts.dialect ?? detectDialect(caller.toolNames) ?? ROVO_DIALECT;
     const resolve = (kind) => {
         const candidates = dialect.toolNames[kind];
         const found = candidates.find((n) => caller.toolNames.includes(n));
-        return found ?? candidates[0] ?? kind;
+        if (found)
+            return found;
+        const advertised = caller.toolNames.slice(0, 12).join(", ");
+        throw new Error(`No MCP tool for "${kind}": dialect "${dialect.name}" expects one of ` +
+            `[${candidates.join(", ")}], but the server advertises [${advertised}` +
+            `${caller.toolNames.length > 12 ? ", …" : ""}]. ` +
+            `Set jira.mcp.dialect in raptor.yml to match your server.`);
     };
     const parseIssue = (data) => parseJiraIssue(data, opts.baseUrl);
     return {
@@ -87,7 +93,11 @@ export async function connectJira(opts = {}) {
     });
 }
 export async function connectMcpServer(cfg) {
-    const dialect = resolveDialect(cfg.dialect);
+    const missing = missingEnvRefs(cfg.env ?? {});
+    if (missing.length) {
+        process.stderr.write(`Warning: Jira MCP env var(s) referenced but unset/empty: ${missing.join(", ")} ` +
+            `— the spawned server may fail to authenticate.\n`);
+    }
     const transport = new StdioClientTransport({
         command: cfg.command,
         args: cfg.args ?? [],
@@ -97,10 +107,22 @@ export async function connectMcpServer(cfg) {
     const client = new Client({ name: "raptor-cli", version: "0.1.0" }, { capabilities: {} });
     await client.connect(transport);
     return makeJiraClient(await clientToToolCaller(client), {
-        dialect,
+        ...(cfg.dialect ? { dialect: resolveDialect(cfg.dialect) } : {}),
         ...(cfg.base_url ? { baseUrl: cfg.base_url } : {}),
     });
 }
+export function missingEnvRefs(env, source = process.env) {
+    const missing = new Set();
+    for (const raw of Object.values(env)) {
+        for (const m of raw.matchAll(/\$\{([A-Za-z_][A-Za-z0-9_]*)(:-[^}]*)?\}/g)) {
+            const name = m[1];
+            const hasDefault = m[2] !== undefined;
+            if (!hasDefault && !source[name])
+                missing.add(name);
+        }
+    }
+    return [...missing];
+}
 export function expandEnv(env, source = process.env) {
     const out = {};
     for (const [k, raw] of Object.entries(env)) {

package/dist/_core/dist/models/tasks.js

@@ -30,15 +30,18 @@ export function parseTaskList(body) {
             const rest = m[2] ?? "";
             const stories = [...rest.matchAll(/\[(US\d+)\]/gi)].map((mm) => mm[1]);
             const story = stories[0];
+            const acceptance = [...rest.matchAll(/\[(AC-\d+)\]/gi)].map((mm) => mm[1]);
             const parallel = /\[P\]/i.test(rest);
             const description = rest
                 .replace(/\[US\d+\]/gi, "")
+                .replace(/\[AC-\d+\]/gi, "")
                 .replace(/\[P\]/gi, "")
                 .trim();
             items.push({
                 id,
                 ...(story ? { story } : {}),
                 stories,
+                acceptance,
                 parallel,
                 description,
                 status,
@@ -72,3 +75,11 @@ export function markTaskCompleted(body, taskId) {
     }
     return lines.join("\n");
 }
+export function buildTaskAcceptanceMap(taskList) {
+    const map = {};
+    for (const t of taskList) {
+        if (t.acceptance.length > 0)
+            map[t.id] = t.acceptance;
+    }
+    return map;
+}

package/dist/_core/package.json

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

package/dist/commands/doctor.js

@@ -2,8 +2,9 @@ import { execSync } from "node:child_process";
 import { BaseCommand } from "../base-command.js";
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
-import { CORE_VERSION, coreHash, extractCoreBlock, getPreset, knownPresetIds, MANIFEST_SCHEMA_VERSION, validateManifest, validateFeatureState, validateInitOptions, VERSION, detectInstalledAgents, discoverSkills, loadSkillsConfig, validateSkillsConfig, skillTargetPath, loadMcpConfig, validateMcpConfig, isServerMaterialized, mcpTargetFor, } from "../_core/dist/index.js";
+import { CORE_VERSION, coreHash, extractCoreBlock, knownPresetIds, MANIFEST_SCHEMA_VERSION, validateManifest, validateFeatureState, validateInitOptions, VERSION, detectInstalledAgents, discoverSkills, loadSkillsConfig, validateSkillsConfig, skillTargetPath, loadMcpConfig, validateMcpConfig, isServerMaterialized, mcpTargetFor, } from "../_core/dist/index.js";
 import { findProjectRoot, readConfig } from "../shared/project.js";
+import { resolveActivePresets } from "../shared/presets.js";
 import { configuredAdapters } from "../shared/agents.js";
 import { configuredMcpAgentIds } from "../shared/mcp.js";
 export default class Doctor extends BaseCommand {
@@ -140,30 +141,29 @@ export default class Doctor extends BaseCommand {
                 detail: "Missing",
             });
         }
-        if (config.preset) {
-            const preset = getPreset(config.preset);
-            if (preset) {
-                checks.push({
-                    name: "Preset",
-                    status: "pass",
-                    detail: `${preset.id} v${preset.version} (${preset.articles.length} articles, ${preset.gates.length} gates)`,
-                });
-            }
-            else {
-                checks.push({
-                    name: "Preset",
-                    status: "warn",
-                    detail: `"${config.preset}" not registered — known: ${knownPresetIds().join(", ")}`,
-                });
-            }
-        }
-        else {
+        const resolvedPresets = resolveActivePresets(config);
+        if (resolvedPresets.ids.length === 0) {
             checks.push({
                 name: "Preset",
                 status: "warn",
                 detail: "No preset configured",
             });
         }
+        else if (resolvedPresets.unknownIds.length > 0) {
+            checks.push({
+                name: "Preset",
+                status: "warn",
+                detail: `not registered: ${resolvedPresets.unknownIds.join(", ")} — known: ${knownPresetIds().join(", ")}`,
+            });
+        }
+        else {
+            const articleCount = resolvedPresets.presets.reduce((n, p) => n + p.articles.length, 0);
+            checks.push({
+                name: "Preset",
+                status: "pass",
+                detail: `${resolvedPresets.ids.join(", ")} (${articleCount} articles, ${resolvedPresets.gates.length} gates)`,
+            });
+        }
         try {
             const agents = detectInstalledAgents();
             if (agents.length > 0) {

package/dist/commands/gate/approve.js

@@ -1,8 +1,9 @@
 import { Args, Flags } from "@oclif/core";
 import { BaseCommand } from "../../base-command.js";
 import { basename, join } from "node:path";
-import { appendAuditEvent, gateById, getPreset, } from "../../_core/dist/index.js";
+import { appendAuditEvent, gateById, } from "../../_core/dist/index.js";
 import { auditableDir, currentActor, readConfig, requireProjectRoot, } from "../../shared/project.js";
+import { resolveActivePresets } from "../../shared/presets.js";
 import { runAfterHook, runBeforeHook } from "../../shared/hooks.js";
 export default class GateApprove extends BaseCommand {
     static description = "Record human approval of a gate against a feature (emits gate.approved). " +
@@ -39,8 +40,7 @@ export default class GateApprove extends BaseCommand {
         const dir = auditableDir(root, args.feature);
         const featureName = basename(dir);
         const config = readConfig(root);
-        const preset = config.preset ? getPreset(config.preset) : undefined;
-        const presetGates = preset?.gates ?? [];
+        const { gates: presetGates } = resolveActivePresets(config);
         const gate = gateById(args.gateId) ?? presetGates.find((g) => g.id === args.gateId);
         if (!gate) {
             this.error(`unknown gate: ${args.gateId}. Run 'raptor gate list' to see valid ids.`);

package/dist/commands/gate/list.js

@@ -1,6 +1,7 @@
-import { BUILTIN_GATES, getPreset, listPresets } from "../../_core/dist/index.js";
+import { BUILTIN_GATES, listPresets } from "../../_core/dist/index.js";
 import { BaseCommand } from "../../base-command.js";
 import { findProjectRoot, readConfig } from "../../shared/project.js";
+import { resolveActivePresets } from "../../shared/presets.js";
 export default class GateList extends BaseCommand {
     static description = "List all built-in gates, their levels and article references";
     async run() {
@@ -13,13 +14,12 @@ export default class GateList extends BaseCommand {
             this.log(`${g.id.padEnd(30)}  ${g.level.padEnd(8)}  ${art.padEnd(7)}  ${g.title}`);
         }
         const root = findProjectRoot();
-        const activePresetId = root ? readConfig(root).preset : undefined;
-        const presets = activePresetId
-            ? [getPreset(activePresetId)].filter(Boolean)
-            : listPresets();
+        const resolved = root ? resolveActivePresets(readConfig(root)) : undefined;
+        const activeIds = new Set(resolved?.ids ?? []);
+        const presets = resolved && resolved.presets.length ? resolved.presets : listPresets();
         for (const p of presets) {
             this.log("");
-            this.log(`=== Preset: ${p.id} v${p.version}${activePresetId === p.id ? " (active)" : ""} ===`);
+            this.log(`=== Preset: ${p.id} v${p.version}${activeIds.has(p.id) ? " (active)" : ""} ===`);
             this.log("");
             this.log("ID                              LEVEL     ARTICLE  TITLE");
             this.log("──────────────────────────────  ────────  ───────  ─────────────────────────────");

package/dist/commands/gate/skip.js

@@ -1,8 +1,9 @@
 import { Args, Flags } from "@oclif/core";
 import { BaseCommand } from "../../base-command.js";
 import { basename, join } from "node:path";
-import { appendAuditEvent, gateById, getPreset, } from "../../_core/dist/index.js";
+import { appendAuditEvent, gateById, } from "../../_core/dist/index.js";
 import { auditableDir, currentActor, readConfig, requireProjectRoot, } from "../../shared/project.js";
+import { resolveActivePresets } from "../../shared/presets.js";
 import { runAfterHook, runBeforeHook } from "../../shared/hooks.js";
 export default class GateSkip extends BaseCommand {
     static description = "Record a justified skip of a non-critical gate (emits gate.skipped). " +
@@ -32,8 +33,7 @@ export default class GateSkip extends BaseCommand {
         const dir = auditableDir(root, args.feature);
         const featureName = basename(dir);
         const config = readConfig(root);
-        const preset = config.preset ? getPreset(config.preset) : undefined;
-        const presetGates = preset?.gates ?? [];
+        const { gates: presetGates } = resolveActivePresets(config);
         const gate = gateById(args.gateId) ?? presetGates.find((g) => g.id === args.gateId);
         if (!gate) {
             this.error(`unknown gate: ${args.gateId}. Run 'raptor gate list' to see valid ids.`);

package/dist/commands/plan.js

@@ -3,8 +3,9 @@ import { BaseCommand } from "../base-command.js";
 import { step, heading } from "../shared/ui.js";
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { basename, join } from "node:path";
-import { appendAuditEvent, buildCanonicalPrompt, coreHash, extractCoreBlock, getPreset, hashString, loadAgentsConfig, parseSpec, renderBundled, renderPresetGatesForPlan, selectAgent, } from "../_core/dist/index.js";
+import { appendAuditEvent, buildCanonicalPrompt, coreHash, extractCoreBlock, hashString, loadAgentsConfig, parseSpec, renderBundled, renderPresetGatesForPlan, selectAgent, } from "../_core/dist/index.js";
 import { currentActor, featureDir, readConfig, requireProjectRoot, } from "../shared/project.js";
+import { resolveActivePresets } from "../shared/presets.js";
 import { writeFeaturePrompt } from "../shared/feature-prompt.js";
 import { runAfterHook, runBeforeHook } from "../shared/hooks.js";
 import { backupPhaseFile, waitForPhaseArtifact, } from "../shared/artifact-io.js";
@@ -82,7 +83,7 @@ export default class Plan extends BaseCommand {
         }
         const constitutionHash = extracted.declaredHash;
         const config = readConfig(root);
-        const preset = config.preset ? getPreset(config.preset) : undefined;
+        const { stacked: preset } = resolveActivePresets(config);
         const presetGatesBlock = preset
             ? renderPresetGatesForPlan(preset)
             : "*(none)*";

package/dist/commands/status.js

@@ -4,7 +4,7 @@ import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { basename, join } from "node:path";
 import { computeAcceptanceCoverage, discoverChecklists, hasUnresolvedClarifications, parseChecklistItems, parseImplLog, parsePlan, parseSpec, parseTasks, parseTaskList, summarizeChecklist, } from "../_core/dist/index.js";
 import { parseFrontmatter } from "../_core/dist/index.js";
-import { featureDir, readConfig, requireProjectRoot, } from "../shared/project.js";
+import { activePresetIds, featureDir, readConfig, requireProjectRoot, } from "../shared/project.js";
 export default class Status extends BaseCommand {
     static description = "Show project or feature status dashboard";
     static examples = [
@@ -31,7 +31,8 @@ export default class Status extends BaseCommand {
         const config = readConfig(root);
         this.log("=== Raptor Project Status ===\n");
         this.log(`  Project:    ${config.project?.name ?? basename(root)}`);
-        this.log(`  Preset:     ${config.preset ?? "(none)"}`);
+        const presetIds = activePresetIds(config);
+        this.log(`  Preset:     ${presetIds.length ? presetIds.join(", ") : "(none)"}`);
         const specsDir = join(root, ".raptor", "specs");
         const features = existsSync(specsDir)
             ? readdirSync(specsDir).filter((d) => /^\d{3}-/.test(d))
@@ -137,8 +138,7 @@ export default class Status extends BaseCommand {
             }
         }
         const config = readConfig(root);
-        const preset = config.preset || "";
-        if (preset.includes("mobile")) {
+        if (activePresetIds(config).some((id) => id.includes("mobile"))) {
             await this.showM7Dashboard(dir, featureName);
         }
     }

package/dist/commands/verify.js

@@ -2,9 +2,10 @@ import { Args, Flags } from "@oclif/core";
 import { BaseCommand } from "../base-command.js";
 import { existsSync, readdirSync } from "node:fs";
 import { basename, join } from "node:path";
-import { BUILTIN_GATES, formatReport, gateById, getPreset, PROJECT_GATES, readAdrOverrides, runGates, } from "../_core/dist/index.js";
+import { BUILTIN_GATES, formatReport, gateById, PROJECT_GATES, readAdrOverrides, runGates, } from "../_core/dist/index.js";
 const PROJECT_GATE_IDS = new Set(PROJECT_GATES.map((g) => g.id));
 import { featureDir, readConfig, requireProjectRoot, } from "../shared/project.js";
+import { resolveActivePresets } from "../shared/presets.js";
 export default class Verify extends BaseCommand {
     static description = "Run built-in gates against the project or a specific feature (C1–C5 + required checks)";
     static examples = [
@@ -30,11 +31,10 @@ export default class Verify extends BaseCommand {
         const { args, flags } = await this.parse(Verify);
         const root = requireProjectRoot();
         const config = readConfig(root);
-        const preset = config.preset ? getPreset(config.preset) : undefined;
-        if (config.preset && !preset) {
-            this.warn(`raptor.yml declares preset "${config.preset}" but it is not registered — its gates will not run.`);
+        const { gates: presetGates, unknownIds: unknownPresetIds, ids: presetIds, } = resolveActivePresets(config);
+        for (const id of unknownPresetIds) {
+            this.warn(`raptor.yml declares preset "${id}" but it is not registered — its gates will not run.`);
         }
-        const presetGates = preset?.gates ?? [];
         const skipSet = new Set((flags.skip ?? "")
             .split(",")
             .map((s) => s.trim())
@@ -95,7 +95,7 @@ export default class Verify extends BaseCommand {
             }
         }
         const report = await runGates(gatesToRun, { projectRoot: root, featureDir: dir }, { skip: skipSet, skipJustifications, overrides });
-        this.log(`=== Gates for feature ${featureName}${preset ? ` (preset: ${preset.id})` : ""} ===`);
+        this.log(`=== Gates for feature ${featureName}${presetIds.length ? ` (presets: ${presetIds.join(", ")})` : ""} ===`);
         this.log(formatReport(report));
         if (report.blocked)
             this.exit(1);

package/dist/shared/presets.js

@@ -0,0 +1,16 @@
+import { getPreset, stackPresets } from "../_core/dist/index.js";
+import { activePresetIds } from "./project.js";
+export function resolveActivePresets(cfg) {
+    const ids = activePresetIds(cfg);
+    const presets = [];
+    const unknownIds = [];
+    for (const id of ids) {
+        const p = getPreset(id);
+        if (p)
+            presets.push(p);
+        else
+            unknownIds.push(id);
+    }
+    const stacked = presets.length ? stackPresets(presets).preset : undefined;
+    return { ids, presets, unknownIds, stacked, gates: stacked?.gates ?? [] };
+}

package/package.json

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

package/templates/tasks-template.md

@@ -35,13 +35,16 @@ Rules:
 <!-- Format: - **T###** [US#] [AC-#] [P?] — <imperative> in <path/to/file.ext> -->
 
 ### Phase: Setup
+
 - **T001** [meta] — Initialize feature module structure in src/<slug>/
 
 ### Phase: MVP — US1 (P1)
+
 - **T002** [US1] [AC-1] — <first MVP task> in src/<slug>/<file>.ts
-- **T003** [US1] [AC-1] [P] — <add the test> in __tests__/<slug>/<file>.test.ts
+- **T003** [US1] [AC-1] [P] — <add the test> in **tests**/<slug>/<file>.test.ts
 
 ### Phase: US2 (P2)
+
 - **T004** [US2] [AC-2] — <task> in src/<slug>/<file>.ts
 
 ## 3. Dependency Graph

package/templates/checklist-template.md

@@ -1,103 +0,0 @@
-# Quality Checklist — {{featureName}}
-
-> Generated by `/rpt.checklist`. Source: spec.md + plan.md (+ tasks.md if present).
-> Spec Kit ref: E09 — quality gate before `/rpt.implement` proceeds.
-
----
-
-## Metadata
-
-- **Feature**: `{{featureDirectory}}`
-- **Generated**: `{{generatedAt}}`
-- **Spec status**: {{specStatus}}
-- **Plan status**: {{planStatus}}
-
----
-
-## Code Quality
-
-- [ ] All files follow project coding standards (lint clean)
-- [ ] No `TODO` / `FIXME` markers remain in production code
-- [ ] Error handling covers both expected and unexpected failures
-- [ ] Logging follows project conventions (no console.log in prod paths)
-- [ ] Public APIs have type signatures
-- [ ] No dead code or unused imports
-
-## Testing
-
-- [ ] Unit tests cover business logic (target ≥ 80% coverage)
-- [ ] Integration tests for external dependencies
-- [ ] Edge cases documented and tested
-- [ ] Test fixtures are realistic (no `foo`/`bar` placeholders)
-- [ ] Tests are deterministic (no flaky timing/ordering)
-- [ ] Tests run independently (no shared mutable state)
-
-## Security
-
-- [ ] Input validation on all endpoints / boundaries
-- [ ] Authentication and authorization verified
-- [ ] No secrets in code, fixtures, or configuration files
-- [ ] OWASP Top 10 reviewed (injection, XSS, auth, etc.)
-- [ ] Sensitive data handling (PII, tokens) audited
-- [ ] Dependency vulnerabilities checked
-
-## Performance
-
-- [ ] No N+1 query patterns
-- [ ] Pagination on list endpoints
-- [ ] Caching strategy documented (where applicable)
-- [ ] Load characteristics measured for critical paths
-- [ ] Memory / connection pools sized appropriately
-
-## Documentation
-
-- [ ] API documentation reflects new contracts
-- [ ] README updated when surface changes
-- [ ] Architecture decisions recorded (in `plan.md` Decisions section)
-- [ ] Operational runbook (if applicable)
-- [ ] Migration / rollback procedure documented
-
-## Accessibility (UI features)
-
-- [ ] Screen-reader compatible
-- [ ] Keyboard navigation supported (no mouse-only flows)
-- [ ] Color contrast meets WCAG AA
-- [ ] Touch targets ≥ 44px on mobile
-- [ ] Localizable strings (no hardcoded user-facing text)
-
-## Mobile (when applicable)
-
-- [ ] Tested on iOS minimum supported version
-- [ ] Tested on Android minimum supported version
-- [ ] Offline-friendly (graceful degradation)
-- [ ] Battery / data usage acceptable
-- [ ] Push / notification permissions handled correctly
-
-## Constitution
-
-- [ ] No principle violated without explicit, documented mitigation
-- [ ] Test-First respected (where mandated)
-- [ ] Library-First respected (no in-house reimplementation of common libs)
-
-## Observability
-
-- [ ] Critical paths emit logs at appropriate level
-- [ ] Key metrics exported (latency, errors, throughput)
-- [ ] Distributed tracing in place (where applicable)
-- [ ] Alerts wired for SLO violations
-
----
-
-## Sign-Off
-
-- [ ] All boxes above checked OR justified inline with `<!-- justification: ... -->`
-- [ ] Reviewer: `{{reviewerEmail}}`
-- [ ] Date: `{{signOffDate}}`
-
----
-
-## Rules
-
-1. **No partial sign-off**: every box must be ticked OR justified.
-2. **Justifications are auditable**: inline justifications must reference a decision in `plan.md` or an issue number.
-3. **Re-runnable**: `/rpt.checklist` regenerates this file when artifacts change; user-justifications are preserved between runs.