jarvis-ai-framework 5.2.0 → 5.6.0

package/bin/lib/core/env-upgrade.js

@@ -0,0 +1,97 @@
+// Upgrade do ENV.md (`jarvis init --upgrade`): acrescenta as chaves do template que faltam.
+// Regra: só acrescenta. Nenhuma chave existente muda, preenchida, vazia ou com lista de opções.
+// Mesmas regras do Upgrade (C) do skill jarvis-init (itens 4, 5, 9, 10 e 11).
+import { readFileSync, writeFileSync } from "node:fs";
+import { detectWorkspaceMode } from "./workspace-mode.js";
+
+const KEY_LINE = /^([A-Z][A-Z0-9_]*)=(.*)$/;
+
+// PROD_MODE nova: o valor vem da AREA (só no upgrade; a criação do ENV continua perguntando).
+const PROD_MODE_BY_AREA = { ENGINEERING: "developer-guided", PRODUCT: "product-led" };
+
+/**
+ * Lê as chaves do ENV na ordem do arquivo, **incluindo as vazias** (o `loadEnv`
+ * descarta as vazias, o que esconderia uma chave existente do diff).
+ * Linhas comentadas não contam.
+ * @returns {Map<string, string>}
+ */
+export function parseEnvEntries(text) {
+  const entries = new Map();
+  for (const line of text.split("\n")) {
+    const m = line.trim().match(KEY_LINE);
+    if (m && !entries.has(m[1])) entries.set(m[1], m[2].trim());
+  }
+  return entries;
+}
+
+function isOptionList(value) {
+  return /^\[.*\]$/.test(value);
+}
+
+// Bloco "Data Engineering": DATA_* só entram com HUB=DATA. DATA_SPECIALIZATIONS é
+// obrigatória em qualquer HUB (eng.specializations-rules.md) e nunca é excluída.
+function isDataOnlyKey(key) {
+  return key.startsWith("DATA_") && key !== "DATA_SPECIALIZATIONS";
+}
+
+/**
+ * Calcula o que o upgrade acrescenta, sem gravar nada.
+ * @param {string} envText
+ * @param {string} templateText
+ * @param {{ workspaceDir?: string }} [options] - `workspaceDir`: pasta que contém o `$IDE/`, para detectar o `WORKSPACE_MODE`
+ * @returns {{ added: {key: string, value: string}[], pending: string[], warnings: string[] }}
+ *   `pending` e `warnings` trazem só nomes de chave, nunca valores do ENV.
+ */
+export function planEnvUpgrade(envText, templateText, { workspaceDir } = {}) {
+  const env = parseEnvEntries(envText);
+  const template = parseEnvEntries(templateText);
+  const hub = (env.get("HUB") || "").toUpperCase();
+  const area = (env.get("AREA") || "").toUpperCase();
+
+  const added = [];
+  const pending = [];
+  const warnings = [];
+
+  for (const [key, templateValue] of template) {
+    if (env.has(key)) continue;
+    if (hub !== "DATA" && isDataOnlyKey(key)) continue;
+
+    let value = isOptionList(templateValue) ? "" : templateValue;
+    if (key === "PROD_MODE") {
+      value = PROD_MODE_BY_AREA[area] || "";
+      if (!value) pending.push("PROD_MODE");
+    }
+    if (key === "WORKSPACE_MODE" && workspaceDir) {
+      const repos = (env.get("WORKSPACE_REPOS") || "")
+        .split(",")
+        .map((r) => r.trim())
+        .filter(Boolean);
+      const detected = detectWorkspaceMode(workspaceDir, { repos });
+      value = detected.mode;
+      if (detected.warning) warnings.push("WORKSPACE_MODE");
+    }
+    added.push({ key, value });
+  }
+
+  if (env.has("PROD_MODE") && !env.get("PROD_MODE")) pending.push("PROD_MODE");
+
+  if (env.get("CENTRAL_DOCS_REPO") && !env.has("CENTRAL_DOCS_STORAGE")) {
+    warnings.push("CENTRAL_DOCS_REPO");
+  }
+
+  return { added, pending, warnings };
+}
+
+/**
+ * Grava as chaves novas no fim do ENV, num bloco datado. Nenhuma linha existente muda.
+ * `overrides` troca o valor de chaves novas (ex.: recusa em mover os discoveries).
+ * @returns {boolean} true se gravou
+ */
+export function applyEnvUpgrade(envPath, plan, today, overrides = {}) {
+  if (plan.added.length === 0) return false;
+  const text = readFileSync(envPath, "utf-8");
+  const lines = plan.added.map(({ key, value }) => `${key}=${overrides[key] ?? value}`);
+  const sep = text.endsWith("\n") ? "" : "\n";
+  writeFileSync(envPath, `${text}${sep}\n# --- Upgrade ${today} ---\n${lines.join("\n")}\n`);
+  return true;
+}

package/bin/lib/core/profile-filter.js

@@ -7,7 +7,9 @@
  * `rules/AGENTS.md`: ao mudar uma, mude as três.
  *
  * Regras:
- * - Os quatro eixos (HUB, POSITION, AREA, SQUAD) são combinados com AND.
+ * - Os eixos (HUB, POSITION, AREA, SQUAD e o opcional ARTIFACT_STYLE) são combinados com AND.
+ * - ARTIFACT_STYLE (5º campo, opcional): ausente no bloco = `all`; perfil sem valor =
+ *   `ai-generated`. Sem coringa: FULLCYCLE e GENERALIST não o satisfazem (é escolha da pessoa).
  * - `all` casa qualquer valor; listas são separadas por vírgula.
  * - FULLCYCLE (HUB) satisfaz qualquer HUB.
  * - GENERALIST (POSITION) satisfaz qualquer POSITION e qualquer AREA.
@@ -20,8 +22,11 @@
 import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { join, relative, sep } from "node:path";
 
+// SQUAD para no próximo `|`: o 5º campo (ARTIFACT_STYLE) é opcional.
 const APPLIES_TO_RE =
-  /> \*\*Applies to:\*\* HUB: ([^|]+)\| POSITION: ([^|]+)\| AREA: ([^|]+)\| SQUAD: (.+)/;
+  /> \*\*Applies to:\*\* HUB: ([^|]+)\| POSITION: ([^|]+)\| AREA: ([^|]+)\| SQUAD: ([^|\n]+)(?:\| ARTIFACT_STYLE: ([^|\n]+))?/;
+
+const DEFAULT_ARTIFACT_STYLE = "ai-generated";
 
 /**
  * @typedef {Object} AppliesTo
@@ -29,6 +34,7 @@ const APPLIES_TO_RE =
  * @property {string} POSITION
  * @property {string} AREA
  * @property {string} SQUAD
+ * @property {string} ARTIFACT_STYLE - `all` quando o bloco não traz o campo
  */
 
 /**
@@ -37,6 +43,7 @@ const APPLIES_TO_RE =
  * @property {string} POSITION
  * @property {string} AREA
  * @property {string} SQUAD
+ * @property {string} [ARTIFACT_STYLE] - vazio = `ai-generated`
  */
 
 /**
@@ -52,6 +59,7 @@ export function parseAppliesTo(content) {
     POSITION: match[2].trim(),
     AREA: match[3].trim(),
     SQUAD: match[4].trim(),
+    ARTIFACT_STYLE: (match[5] || "all").trim(),
   };
 }
 
@@ -76,7 +84,11 @@ export function matchesProfile(appliesTo, profile) {
   const position = generalist || axisMatches(appliesTo.POSITION, profile.POSITION);
   const area = generalist || axisMatches(appliesTo.AREA, profile.AREA);
   const squad = axisMatches(appliesTo.SQUAD, profile.SQUAD);
-  return hub && position && area && squad;
+  const style = axisMatches(
+    appliesTo.ARTIFACT_STYLE || "all",
+    profile.ARTIFACT_STYLE || DEFAULT_ARTIFACT_STYLE
+  );
+  return hub && position && area && squad && style;
 }
 
 function walkMarkdown(dir) {

package/bin/lib/core/stale-skills.js

@@ -0,0 +1,63 @@
+// Skills obsoletos (`jarvis init --upgrade`): skills instalados na pasta da IDE que não existem
+// mais no framework (renomeados ou removidos). O upgrade só LISTA e, com confirmação, remove.
+// Nunca marca como obsoleto um skill registrado em alguma lista `*_SPECIALIZATIONS` do ENV.md
+// (especializações criadas pelo usuário com o jarvis-create-specialization).
+// Só lê nomes de pasta: nunca lê nem imprime o conteúdo dos skills.
+import { existsSync, readdirSync, rmSync } from "node:fs";
+import { join } from "node:path";
+
+const SKILL_NAME = /^[a-z0-9][a-z0-9-]*$/;
+
+/**
+ * Nomes registrados nas listas `*_SPECIALIZATIONS` do ENV (aceita vírgulas, colchetes, aspas e espaços).
+ * @param {Map<string, string>} entries - `parseEnvEntries(envText)`
+ * @returns {Set<string>}
+ */
+export function registeredSpecializations(entries) {
+  const names = new Set();
+  for (const [key, value] of entries) {
+    if (!key.endsWith("_SPECIALIZATIONS")) continue;
+    for (const item of value.replace(/[[\]"']/g, "").split(",")) {
+      const name = item.trim();
+      if (name) names.add(name);
+    }
+  }
+  return names;
+}
+
+/**
+ * @param {{ ideSkillsDir: string, frameworkSkillsDir: string, registered?: Set<string> }} p
+ * @returns {string[]} nomes (pastas) de skills instalados que o framework não tem mais
+ */
+export function findStaleSkills({ ideSkillsDir, frameworkSkillsDir, registered = new Set() }) {
+  if (!existsSync(ideSkillsDir)) return [];
+  return readdirSync(ideSkillsDir, { withFileTypes: true })
+    .filter((e) => e.isDirectory() && SKILL_NAME.test(e.name))
+    .map((e) => e.name)
+    .filter((name) => existsSync(join(ideSkillsDir, name, "SKILL.md")))
+    .filter((name) => !existsSync(join(frameworkSkillsDir, name)))
+    .filter((name) => !registered.has(name))
+    .sort();
+}
+
+/**
+ * Remove as pastas listadas, uma a uma (só nomes já validados por `findStaleSkills`).
+ * @returns {{ removed: string[], errors: string[] }}
+ */
+export function removeStaleSkills(ideSkillsDir, names) {
+  const removed = [];
+  const errors = [];
+  for (const name of names) {
+    if (!SKILL_NAME.test(name)) {
+      errors.push(`${name}: nome inválido`);
+      continue;
+    }
+    try {
+      rmSync(join(ideSkillsDir, name), { recursive: true, force: true });
+      removed.push(name);
+    } catch (err) {
+      errors.push(`${name}: ${err.message}`);
+    }
+  }
+  return { removed, errors };
+}

package/bin/lib/core/sync-engine.js

@@ -149,7 +149,7 @@ export function syncAssets(targetDir, ide, opts = {}) {
 
   // RTK: detectar e reconciliar RTK_ENABLED + rtk-rules.md
   if (!opts.dryRun) {
-    const rtkResult = reconcileRtk(ideDir, targetDir, ide);
+    const rtkResult = reconcileRtk(ideDir, targetDir, ide, { keepEnvValues: opts.keepEnvValues });
     if (rtkResult) result.copied.push(rtkResult);
   }
 
@@ -191,9 +191,11 @@ export function syncAssets(targetDir, ide, opts = {}) {
  * Detecta RTK no PATH e reconcilia RTK_ENABLED no ENV.md + rtk-rules.md na IDE.
  * - RTK encontrado → RTK_ENABLED=true no ENV.md, mantém rule
  * - RTK não encontrado → remove rtk-rules.md da IDE, mantém RTK_ENABLED=false
+ * - `keepEnvValues` (jarvis init --upgrade): não troca RTK_ENABLED=false por true, porque o
+ *   upgrade só acrescenta chaves novas; acrescentar RTK_ENABLED quando ela não existe continua valendo
  * @returns {string|null} mensagem de log ou null se nenhuma ação
  */
-function reconcileRtk(ideDir, targetDir, ide) {
+function reconcileRtk(ideDir, targetDir, ide, { keepEnvValues = false } = {}) {
   const rtkRulePath = join(ideDir, "rules", "rtk-rules.md");
   const envPath = join(ideDir, "ENV.md");
   const hasRtk = (() => {
@@ -209,7 +211,7 @@ function reconcileRtk(ideDir, targetDir, ide) {
     // Ativar RTK_ENABLED no ENV.md se existir e estiver false
     if (existsSync(envPath)) {
       let env = readFileSync(envPath, "utf-8");
-      if (env.includes("RTK_ENABLED=false")) {
+      if (env.includes("RTK_ENABLED=false") && !keepEnvValues) {
         env = env.replace("RTK_ENABLED=false", "RTK_ENABLED=true");
         writeFileSync(envPath, env, "utf-8");
         return "(rtk) detectado — RTK_ENABLED=true no ENV.md";

package/bin/lib/core/token-report.js

@@ -91,6 +91,7 @@ export function buildReport(root, profile, opts = {}) {
       POSITION: profile.POSITION,
       AREA: profile.AREA,
       SQUAD: profile.SQUAD,
+      ARTIFACT_STYLE: profile.ARTIFACT_STYLE || "ai-generated",
     },
     rtkEnabled,
     estimate: `tokens = bytes ÷ ${BYTES_PER_TOKEN} (estimativa)`,

package/bin/lib/core/workspace-mode.js

@@ -0,0 +1,57 @@
+// Modo de trabalho do workspace (WORKSPACE_MODE): decide se a pasta que contém o `$IDE/` é
+// um projeto único ou um workspace. O que define o modo é a RAIZ ser ou não um repositório,
+// e não quantos repositórios existem dentro dela:
+//   - raiz com `.git`                                  → "project" (o git já delimita o código)
+//   - raiz sem `.git` e 1+ subpastas com `.git`        → "workspace"
+//   - raiz sem `.git` e nenhuma subpasta com `.git`    → "project" (padrão)
+// Caso ambíguo (raiz com `.git` e subpastas também com `.git`, como submódulos): "project" + aviso.
+import { existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+
+export const WORKSPACE_MODES = ["workspace", "project"];
+
+/** Subpastas diretas com `.git` (arquivo ou pasta). Ignora ocultas e `node_modules`. */
+function listGitSubdirs(dir) {
+  let entries;
+  try {
+    entries = readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+  return entries
+    .filter((e) => e.isDirectory() && !e.name.startsWith(".") && e.name !== "node_modules")
+    .filter((e) => existsSync(join(dir, e.name, ".git")))
+    .map((e) => e.name)
+    .sort();
+}
+
+/**
+ * @param {string} workspaceDir - pasta que contém o `$IDE/`
+ * @param {{ repos?: string[] }} [options] - `repos`: allowlist (WORKSPACE_REPOS); vazia = todas
+ * @returns {{ mode: "workspace"|"project", repos: string[], warning: string|null }}
+ */
+export function detectWorkspaceMode(workspaceDir, { repos = [] } = {}) {
+  const rootIsRepo = existsSync(join(workspaceDir, ".git"));
+  const allow = new Set(repos);
+  const found = listGitSubdirs(workspaceDir).filter((n) => allow.size === 0 || allow.has(n));
+
+  if (rootIsRepo) {
+    return {
+      mode: "project",
+      repos: [],
+      warning: found.length
+        ? "a raiz é um repositório e há subpastas com .git (submódulos ou repositórios aninhados): tratada como projeto único"
+        : null,
+    };
+  }
+  if (found.length >= 1) return { mode: "workspace", repos: found, warning: null };
+  return { mode: "project", repos: [], warning: null };
+}
+
+/** Lê o valor do ENV: só `workspace` ou `project` (sem diferenciar maiúsculas); outro valor = null. */
+export function normalizeWorkspaceMode(value) {
+  const v = String(value || "")
+    .trim()
+    .toLowerCase();
+  return WORKSPACE_MODES.includes(v) ? v : null;
+}

package/bin/lib/docs/storage/build-index.js

@@ -53,7 +53,8 @@ export function renderIndex(root, squad) {
     const areaDir = join(root, squad, area);
     const files = walkFiles(areaDir).filter((f) => {
       const name = f.split(sep).pop();
-      return name.startsWith(prefix) && name.endsWith(".md");
+      // {nome}.public.md (versão humanizada, ARTIFACT_STYLE=human-generated) não entra no índice
+      return name.startsWith(prefix) && name.endsWith(".md") && !name.endsWith(".public.md");
     });
     out.push(`## ${area}`, "", `> ${title}`, "");
     if (files.length === 0) {

package/bin/lib/vcs/api.js

@@ -108,6 +108,14 @@ export async function createMergeRequest(repoUrl, opts) {
   };
 }
 
+// Tipos de issue do Bitbucket (campo `kind`; ele não tem labels livres).
+const BITBUCKET_KINDS = ["bug", "enhancement", "proposal", "task"];
+
+/**
+ * @param {string} repoUrl
+ * @param {{ title: string, body: string, labels?: string[] }} opts - `labels` padrão: ["bug"].
+ *   No Bitbucket, a primeira label vira o `kind` quando é um tipo válido; senão, `bug`.
+ */
 export async function createIssue(repoUrl, opts) {
   const { title, body, labels = ["bug"] } = opts;
   const repo = parseRepoUrl(repoUrl);
@@ -149,7 +157,11 @@ export async function createIssue(repoUrl, opts) {
     {
       method: "POST",
       headers,
-      body: { title, content: { raw: body } },
+      body: {
+        title,
+        content: { raw: body },
+        kind: BITBUCKET_KINDS.includes(labels[0]) ? labels[0] : "bug",
+      },
     }
   );
   if (!ok || !json?.links?.html?.href) {

package/bin/lib/vcs/create-issue.js

@@ -9,11 +9,25 @@ import { createIssue, parseRepoUrl } from "./api.js";
  * @param {string} options.repo - URL ou `org/repo` do repositório
  * @param {string} options.title - Título da issue
  * @param {string} options.bodyFile - Path de um arquivo com o corpo em markdown
+ * @param {string} [options.labels] - Labels separadas por vírgula (padrão: bug)
  */
-export async function runCreateIssue({ repo, title, bodyFile }) {
+/**
+ * "enhancement, documentation" → ["enhancement", "documentation"]; vazio → undefined (padrão: bug).
+ * @param {string} [raw]
+ * @returns {string[] | undefined}
+ */
+export function parseLabels(raw) {
+  const list = String(raw || "")
+    .split(",")
+    .map((l) => l.trim())
+    .filter(Boolean);
+  return list.length ? list : undefined;
+}
+
+export async function runCreateIssue({ repo, title, bodyFile, labels }) {
   if (!title || !bodyFile || !repo) {
     console.error(
-      "Uso: jarvis vcs create-issue --repo <url-ou-path> --title <titulo> --body-file <path>"
+      "Uso: jarvis vcs create-issue --repo <url-ou-path> --title <titulo> --body-file <path> [--label <labels>]"
     );
     process.exit(1);
   }
@@ -33,7 +47,7 @@ export async function runCreateIssue({ repo, title, bodyFile }) {
   const body = existsSync(bodyFile) ? readFileSync(bodyFile, "utf-8") : "";
 
   try {
-    const result = await createIssue(repoUrl, { title, body });
+    const result = await createIssue(repoUrl, { title, body, labels: parseLabels(labels) });
     parseRepoUrl(repoUrl);
     console.log(`✅ Issue aberto: ${result.url}`);
     console.log(JSON.stringify(result));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jarvis-ai-framework",
-  "version": "5.2.0",
+  "version": "5.6.0",
   "description": "Jarvis framework",
   "type": "module",
   "bin": {
@@ -11,7 +11,7 @@
     "prepublishOnly": "echo 'Publishing jarvis-framework...'",
     "publish:gitlab": "npm publish",
     "test:comandos": "node test/comandos-docs.test.js",
-    "test:filtro": "node --test test/profile-filter.test.js test/token-report.test.js test/flow-map.test.js test/env-loader.test.js test/sync-engine.test.js test/vcs-api.test.js test/fetch-file.test.js test/publish-file.test.js test/docs-storage.test.js",
+    "test:filtro": "node --test test/profile-filter.test.js test/token-report.test.js test/flow-map.test.js test/env-loader.test.js test/sync-engine.test.js test/vcs-api.test.js test/fetch-file.test.js test/publish-file.test.js test/docs-storage.test.js test/env-upgrade.test.js test/docs-migrate.test.js test/init-upgrade.test.js test/workspace-mode.test.js test/stale-skills.test.js",
     "lint": "eslint bin/ test/",
     "lint:fix": "eslint bin/ test/ --fix",
     "format": "prettier --write bin/ test/",

package/rules/AGENTS.md

@@ -75,6 +75,8 @@ Cada arquivo de rule declara para quais perfis se aplica via bloco `applies_to`,
 > **Applies to:** HUB: {valor ou all} | POSITION: {valor ou all} | AREA: {valor ou all} | SQUAD: {valor ou all}
 ```
 
+Campo opcional no fim: `| ARTIFACT_STYLE: {ai-generated, human-generated ou all}` (ausente = `all`).
+
 **Eixos de filtragem:**
 
 | Eixo | Exemplos de valor | `all` significa |
@@ -83,13 +85,14 @@ Cada arquivo de rule declara para quais perfis se aplica via bloco `applies_to`,
 | POSITION | TECH LEAD, PM, QA-ENGINEER, SENIOR, GENERALIST | qualquer cargo |
 | AREA | ENGINEERING, PRODUCT | qualquer área |
 | SQUAD | CORE | qualquer squad |
+| ARTIFACT_STYLE (opcional) | ai-generated, human-generated | qualquer estilo (ENV vazio = `ai-generated`; sem coringa) |
 
 **Regras:**
 - Uma rule é aplicada se **todos** os eixos forem satisfeitos (AND, não OR)
 - Arquivos sem bloco `applies_to` são considerados **universais** — copiados para qualquer perfil
 - `rules/AGENTS.md` nunca é filtrado — sempre copiado
 
-**Quem faz a filtragem:** o skill `/jarvis-init` (Passo 9 — Profile-Aware Rules Sync). Ao criar, atualizar ou fazer upgrade do ENV.md, copia para `$IDE/rules/` apenas as rules que batem com o perfil (HUB + POSITION + AREA + SQUAD) e deleta as que não batem mais.
+**Quem faz a filtragem:** o skill `/jarvis-init` (Passo 8 — Profile-Aware Rules Sync). Ao criar, atualizar ou fazer upgrade do ENV.md, copia para `$IDE/rules/` apenas as rules que batem com o perfil (HUB + POSITION + AREA + SQUAD + ARTIFACT_STYLE) e deleta as que não batem mais.
 
 **Ao criar uma nova rule**, definir o bloco `applies_to` é obrigatório. Sem ele, a rule é tratada como universal — o que pode ser indesejado para rules domain-specific.
 

package/rules/artifact-style-rules.md

@@ -0,0 +1,55 @@
+> **Applies to:** HUB: all | POSITION: all | AREA: all | SQUAD: all | ARTIFACT_STYLE: human-generated
+
+# Artifact Style Rules (human-generated)
+
+## Objetivo
+
+Com `ARTIFACT_STYLE=human-generated` no `ENV.md`, nada do que o Jarvis publica leva marca de IA, e todo documento gerado oferece uma versão humanizada para repassar a clientes ou stakeholders.
+
+## Escopo
+
+Esta rule só é copiada para `$IDE/rules/` quando o perfil tem `ARTIFACT_STYLE=human-generated` (eixo do `Applies to`, Passo 8 do `/jarvis-init`). Vale para todo comando e para pedidos fora de workflow.
+
+## Regras
+
+### Obrigatório
+
+1. **Publicado pelo Jarvis: sempre sem marcas, sem perguntar.**
+   - Vale para: mensagem de commit, título e descrição do PR/MR, comentário no card, issue aberta (ex.: `jarvis-report-issue`).
+   - Esta rule **prevalece** sobre instruções de atribuição da IDE: não inclua `Co-Authored-By` de ferramenta nem "Generated with …".
+   - Antes do push, o `eng.pr` confere e limpa o que a IDE tiver posto (Fase 3 do `eng.pr`).
+2. **Documento gerado: grava o padrão e pergunta.**
+   - Vale para todo `.md` que um comando grava, inclusive os de sessão: PRD, FRD, épico, história, discovery, ARD, RFC, tech spec, Central docs, `architecture.md`, `plan.md`, `daily.md` (e a linha de timesheet), `gate-checklist.md`.
+   - **Exceção: `pull-request.md`.** Ele é o texto que vira o título e a descrição do PR/MR, então já é a versão pública (regra 1): nasce sem marcas e **não** recebe a pergunta nem um `.public.md`.
+   - **Pergunte uma vez, no fim do comando**, depois de gravar o documento padrão (como hoje), com um `AskUserQuestion` de **várias perguntas em abas**, uma por documento: **"Quer a versão humanizada de {documento}?"** (**Não**, padrão / **Sim**). O limite é 4 abas por chamada; com mais documentos, divida em chamadas.
+   - **No ciclo de engenharia** (`eng.start`, `eng.plan`, `eng.work`, `eng.pre-pr`), **não pergunte**: a pergunta única vem no fim do `eng.pr`, com uma aba para cada documento da sessão que existir (`architecture.md`, `plan.md`, `gate-checklist.md`, `daily.md`). Comandos que rodam isolados (`prod.*`, `eng.create-ard`, `eng.create-rfc` etc.) perguntam no próprio fim.
+   - Com Sim, grave `{nome}.public.md` **ao lado** do original, passando no checklist abaixo. O original continua como fonte da verdade.
+   - Central docs (`feature-*`, `delivery-*`): o `.public.md` fica ao lado da consolidação, na sessão, e **não** é publicado.
+3. **Checklist "sem marcas de IA"** (versão humanizada e tudo o que é publicado). Não pode ter:
+   - `Co-Authored-By` de ferramenta, "Generated with …" ou links para a ferramenta;
+   - menções a IA, Claude ou outros modelos, assistente, agente, sub-agente ou Advisor;
+   - `recommended_model` nem comentários de frontmatter dirigidos à IA;
+   - "Reportado por: IA" ou qualquer autoria atribuída à ferramenta.
+4. **Estilo da versão humanizada:** texto corrido de pessoa para pessoa. Parágrafos onde cabe parágrafo; lista só quando há itens; sem emojis de status em excesso; sem fórmulas como "Em resumo", "Vale ressaltar". Mantenha o conteúdo, as decisões e os links úteis ao leitor (issue, PR, card).
+
+### Proibido
+
+- Alterar o documento original para gerar a versão humanizada.
+- Publicar commit, PR, comentário ou issue com qualquer item do checklist.
+- Reescrever commits já enviados ao remoto.
+- Contar `{nome}.public.md` na sequência de IDs (`prd-{id}`, `discovery-{id}`…) ou incluí-lo em índices.
+
+### Recomendado
+
+- Com vários documentos gerados, as abas do `AskUserQuestion` (uma por documento) em vez de perguntas em sequência.
+
+## Exceções
+
+- Com `ARTIFACT_STYLE=ai-generated` (ou vazio), esta rule não existe na sessão e nada muda.
+
+## Referências
+
+- `templates/ENV-template.md` (`ARTIFACT_STYLE`)
+- `skills/jarvis-init/SKILL.md` (Pergunta 9 e Passo 8)
+- `workflows/engineering/eng.pr.md` (conferência antes do push)
+- `rules/AGENTS.md` (eixo `ARTIFACT_STYLE` do `Applies to`)

package/rules/engineering/eng-rules.md

@@ -28,6 +28,7 @@ env_file: "@/ENV.md"
     ```
   - **Listas de especializações (presentes, podem estar vazias)**: `BACKEND_SPECIALIZATIONS`, `FRONTEND_SPECIALIZATIONS`, `QA_SPECIALIZATIONS`, `DATA_SPECIALIZATIONS`, `AUTOMATION_SPECIALIZATIONS` e `PLATFORM_SPECIALIZATIONS` devem **existir** no `ENV.md`. Lista **vazia** é válida (só o skill base). Variável **ausente** interrompe o comando daquela área e orienta o Upgrade do `/jarvis-init` — mas só quando um comando daquela área específica é executado (igual já valia pra backend/frontend; não bloqueia comando de uma área não tocada). Detalhes e mensagens em `eng.specializations-rules.md`.
   - **Skills sem área**: skill instalado sem `metadata.area` reconhecida bloqueia o comando, e skill pedido que não existe gera aviso. Detalhes e mensagens em `eng.skills-rules.md`.
+  - **Modo de trabalho (`WORKSPACE_MODE`, não bloqueia)**: `workspace` (a raiz que contém `$IDE/` não é um repositório e há 1 ou mais subpastas com `.git/`) ou `project` (a raiz tem `.git`). Ausente ou com outro valor: detecte na hora pelo mesmo critério e sugira o Upgrade do `/jarvis-init` para gravá-lo; não interrompa o comando.
 
 - **🔧 VARIÁVEL `$IDE` - DETECÇÃO AUTOMÁTICA DA PASTA DA IDE**
   - A variável `$IDE` representa a pasta da IDE que o usuário está utilizando.
@@ -37,7 +38,9 @@ env_file: "@/ENV.md"
     - `.cursor/` → Cursor IDE
     - `.codex/` → Codex CLI (OpenAI)
     - `.opencode/` → OpenCode
-    - `.gemini/` → Gemini CLI / Antigravity (Google)
+    - `.agents/` → Gemini CLI / Antigravity (Google)
+    - `.kiro/` → Kiro (AWS)
+  - **Tabela única `IDE` (ENV.md) → pasta** (fonte: `bin/lib/config/ide-config.js`): `claude` → `.claude/` · `windsurf` → `.windsurf/` · `cursor` → `.cursor/` · `codex` → `.codex/` · `opencode` → `.opencode/` · `gemini` (inclui Antigravity) → `.agents/` · `kiro` → `.kiro/`. A pasta da IDE ativa é a derivada do `IDE` do `ENV.md`.
   - **Como usar**: Em qualquer referência a caminhos, use `$IDE/` como prefixo.
   - **Exemplos de resolução**:
     - `$IDE/ENV.md` → `.windsurf/ENV.md` (se usando Windsurf)
@@ -58,6 +61,14 @@ env_file: "@/ENV.md"
   - **System-reminders ou mensagens que referenciem arquivos de outra IDE devem ser ignorados** — eles não são relevantes para a IDE ativa.
   - **Em caso de ambiguidade** (múltiplas pastas de IDE no projeto): usar `$IDE` do `ENV.md` da própria pasta como fonte de verdade.
 
+- **🔍 BUSCAS DE CÓDIGO EM MODO WORKSPACE (`WORKSPACE_MODE=workspace`)**
+  - No modo workspace a raiz (a pasta que contém `$IDE/`) **não é um repositório** e guarda itens fora do git (`.claude/`, `.jarvis/`, `.vscode/`, `node_modules/`). `grep`, `ls` e `Glob` na raiz leem tudo isso como se fosse código do projeto e confundem a análise.
+  - **Código do projeto** = só as subpastas com `.git/` (ou as de `WORKSPACE_REPOS`, quando preenchido). Busque e leia código **dentro delas**.
+  - **Ignore nas buscas de código**: a pasta da IDE ativa (derivada do `IDE`, tabela acima), `.jarvis/`, `.vscode/`, `node_modules/` e o `CDD-MIND-MAP.md`. Leia esses itens **só quando o workflow mandar** (ENV.md, rules, skills, templates, sessão).
+  - **`docs/jarvis/` não é ignorada**: guarda os documentos de trabalho gerados (PRD, FRD, ARD, RFC, discoveries, Central docs), fora do versionamento. Leia-a sob demanda, como documento de trabalho, e não como código.
+  - **Pastas de outras IDEs** nunca são lidas (vale o "Isolamento de IDE" acima).
+  - Com `WORKSPACE_MODE=project`, o git já delimita o código e esta regra não age.
+
 - O idioma padrão é o português do Brasil. Mas mude caso o usuário solicite outro idioma.
 
 - **🇧🇷 REGRA DE IDIOMA PARA GERAÇÃO DE ARQUIVOS**

package/rules/engineering/eng.integrations-rules.md

@@ -37,7 +37,7 @@ Com board definido, se o key não veio nos argumentos, perguntar o id do card na
 
 Só se `TASK_MANAGER` estiver preenchido com um vendor. Freelance → pular. Falha no comentário não bloqueia o workflow.
 
-Comentar **somente** em eventos relevantes: (a) **desvio do plano** (mudança de direção, fase bloqueada), (b) **auditoria do Advisor** (as questões do `architecture.md` com as opções junto da escolha), (c) **bloqueio** com valor de rastreabilidade, (d) **link do MR**, uma única vez, (e) o **`gate-checklist.md` do `eng.pre-pr`**, só se o usuário responder Sim. **Nunca** comentar início ou fim de etapa ("Iniciando…", "concluído…"): o acompanhamento fica no fluxo e no PR.
+Comentar **somente** em eventos relevantes: (a) **desvio do plano** (mudança de direção, fase bloqueada), (b) **auditoria do Advisor** (as questões do `architecture.md` com as opções junto da escolha), (c) **bloqueio** com valor de rastreabilidade, (d) **link do MR**, uma única vez, (e) o **`gate-checklist.md` do `eng.pre-pr`**, só se o usuário escolher registrar (resumo ou relatório completo). **Nunca** comentar início ou fim de etapa ("Iniciando…", "concluído…"): o acompanhamento fica no fluxo e no PR.
 
 ```
 /eng-global-task-comment {TASK_MANAGER_KEY} {mensagem}

package/rules/product/prod-rules.md

@@ -40,12 +40,14 @@ PROD_RULES=$RULES_FOLDER/$PROD_FOLDER_NAME
 PROD_FLOWS=.$IDE/$FLOWS_FOLDER
 PROD_TEMPLATES=.$IDE/$TEMPLATES_FOLDER/$PROD_FOLDER_NAME
 PROD_DOCS=$DOCS_FOLDER/jarvis/$PROD_FOLDER_NAME
+DISCOVERIES_DOCS=$DOCS_FOLDER/jarvis/discoveries
 ```
 
 Abaixo, segue uma descrição de algumas das variáveis mais importantes para as rotinas de produto:
 
 - $DOCS_FOLDER é o nome da pasta principal de documentações do projeto. Ela fica localizada na raiz do projeto.
-- $PROD_DOCS é a pasta dos documentos de produto gerados pelos comandos (PRD, FRD, épicos, histórias, discovery): `$JARVIS_DOCS/product` (`docs/jarvis/product`), nos dois modos de trabalho e fora do versionamento do código. Os de engenharia ficam em `$ENG_DOCS` (`docs/jarvis/engineering`).
+- $PROD_DOCS é a pasta dos documentos de produto gerados pelos comandos (PRD, FRD, épicos, histórias): `$JARVIS_DOCS/product` (`docs/jarvis/product`), nos dois modos de trabalho e fora do versionamento do código. Os de engenharia ficam em `$ENG_DOCS` (`docs/jarvis/engineering`).
+- $DISCOVERIES_DOCS é a pasta dos discoveries: `$JARVIS_DOCS/discoveries` (`docs/jarvis/discoveries`), fora de `product/`. ENV sem a variável: use `$PROD_DOCS/discoveries` se essa pasta existir, senão `$JARVIS_DOCS/discoveries`, e avise para rodar `jarvis init --upgrade`.
 - $PROD_FOLDER_NAME é o nome padrão da pasta de produto que será usada em diversos contextos do projeto.
 - $TEMPLATES_FOLDER é o nome da pasta principal de templates do projeto.
 - $PROD_TEMPLATES é o caminho completo para os templates de produto.
@@ -63,7 +65,8 @@ Abaixo, segue uma descrição de algumas das variáveis mais importantes para as
   - `.cursor/` → Cursor IDE
   - `.codex/` → Codex CLI (OpenAI)
   - `.opencode/` → OpenCode
-  - `.gemini/` → Gemini CLI / Antigravity (Google)
+  - `.agents/` → Gemini CLI / Antigravity (Google)
+  - `.kiro/` → Kiro (AWS)
 - **Como usar**: Em qualquer referência a caminhos, use `$IDE/` como prefixo.
 - **Exemplos de resolução**:
   - `$IDE/ENV.md` → `.windsurf/ENV.md` (se usando Windsurf)
@@ -126,7 +129,7 @@ Dentro das pastas do projeto, os caminhos de pastas e o nome dos arquivos finais
 - Documento de Requisitos Funcionais: `$PROD_DOCS/prd-{id}-{nome-do-pai}/frd-{id}-{nome}.md`
 - Épico: `$PROD_DOCS/prd-{id}-{nome-do-pai}/issues/epic-{id}-{nome}.md`
 - História / tarefa: `$PROD_DOCS/prd-{id}-{nome-do-pai}/issues/{story|task}-{id}-{nome}.md`
-- Discovery (rascunho de uma ideia, anterior ao PRD): `$PROD_DOCS/discoveries/discovery-{id}-{nome}.md`. Usa `status` (`in_review` enquanto o rascunho existe; `cancelled` se o veredito for não seguir) e `verdict` (vazio durante a entrevista, `proceed`, `investigate_more` ou `do_not_proceed`). O veredito é uma recomendação; um PRD, FRD, épico ou issue criado depois prevalece como fonte da verdade.
+- Discovery (rascunho de uma ideia, anterior ao PRD): `$DISCOVERIES_DOCS/discovery-{id}-{nome}.md`. Usa `status` (`in_review` enquanto o rascunho existe; `cancelled` se o veredito for não seguir) e `verdict` (vazio durante a entrevista, `proceed`, `investigate_more` ou `do_not_proceed`). O veredito é uma recomendação; um PRD, FRD, épico ou issue criado depois prevalece como fonte da verdade.
 
 O ID deve ser iterado nos novos arquivos seguindo a sequência existente.
 

package/rules/product/prod.spec-rules.md

@@ -147,14 +147,14 @@ A terminologia inconsistente cria confusão. "Cliente" vs "Usuário" vs "Cliente
 
 ### Princípio: Discovery como insumo
 
-**Princípio**: O discovery (`$PROD_DOCS/discoveries/discovery-{id}-{nome}.md`) é um rascunho de suposições. Ele pode servir de contexto para um PRD, FRD, épico ou issue, mas nunca é obrigatório e nunca é tratado como verdade.
+**Princípio**: O discovery (`$DISCOVERIES_DOCS/discovery-{id}-{nome}.md`) é um rascunho de suposições. Ele pode servir de contexto para um PRD, FRD, épico ou issue, mas nunca é obrigatório e nunca é tratado como verdade.
 
 **O discovery é opcional**:
 - Sem discovery apontado, siga o fluxo do comando normalmente, sem procurar na pasta `discoveries/` e sem perguntar nada sobre discovery. Ter arquivos nessa pasta não tem relação com o comando.
 - Exemplos: `/prod.spec.prd já sei o que quero` segue o fluxo de sempre; `/prod.spec.prd discovery-002` carrega o discovery.
 
 **Como apontar e achar o discovery**:
-- O usuário aponta por caminho, nome ou id (como `discovery-002`); procure em `$PROD_DOCS/discoveries/`.
+- O usuário aponta por caminho, nome ou id (como `discovery-002`); procure em `$DISCOVERIES_DOCS/`.
 - Se o arquivo não existir: informe, liste os discoveries da pasta e pergunte qual usar, ou se o usuário prefere seguir sem discovery.
 - Se a pasta `discoveries/` não existir: siga sem discovery e não crie a pasta.
 - Se mais de um arquivo casar com o que o usuário apontou: pergunte qual usar, sem escolher sozinho.

package/rules-on-demand/engineering/eng.plan-rules.md

@@ -261,7 +261,7 @@ Cada fase pode ter uma seção `### Comentários:` para:
 - ✅ Detalhar cada tarefa com contexto
 - ✅ Indicar dependências (sequencial/paralelo)
 - ✅ Usar os emojis de status corretamente
-- ✅ Validar o plano com o humano antes de prosseguir
+- ✅ Validar o plano com o humano antes de prosseguir (pergunta "O que fazer com o plano?" de `eng.transitions-rules.md`)
 - ✅ Escrever tudo em português (pt-BR)
 
 ---

package/rules-on-demand/engineering/eng.pr-rules.md

@@ -271,6 +271,7 @@ O MR deve seguir o template em `$IDE/templates/engineering/PR-template.md`:
 - ❌ Commitar arquivos de configuração local
 - ❌ Commitar credenciais ou tokens
 - ❌ Mencionar AI/Claude no PR
+- ❌ Com `ARTIFACT_STYLE=human-generated`: push de commit ou PR com marca de IA ou da IDE (`Co-Authored-By` de ferramenta, "Generated with …") — conferir antes (Fase 3.0 do `eng.pr`)
 - ❌ [!IMPORTANT] PUSH DIRETO PARA `main`/`dev`
 
 ### ✅ SEMPRE FAÇA
@@ -322,20 +323,20 @@ Antes de considerar o PR completo:
 - [ ] Card do Jira movido para "In Review"
 - [ ] Comentários de code review processados
 - [ ] `pull-request.md` aprovado na sessão (e publicado, se o usuário respondeu Sim)
-- [ ] Lembrete do `/eng.spec-consolidate` na mensagem final
-- [ ] `daily.md` gerado ou atualizado e aprovado (só com PR aberto), com a linha de timesheet na mensagem final
+- [ ] Pergunta "O PR já foi aprovado e mergeado?" no fim (Sim → `/eng.spec-consolidate`)
+- [ ] `daily.md` gerado ou atualizado e aprovado (com ou sem PR publicado), com a linha de timesheet na mensagem final
 
 ---
 
 ## Sessão e publicação
 
 - O texto do PR fica em **`$SESSIONS_DIR/eng/{TASK_MANAGER_KEY}/pull-request.md`**, aprovado pelo usuário.
-- **Publicar (push + MR/PR) só com o Sim** do `AskUserQuestion` "Publicar o PR agora?". Com Não, o arquivo fica na sessão e nada é enviado.
-- **A sessão nunca é apagada por este comando:** o `/eng.spec-consolidate`, que roda em seguida, precisa do `architecture.md`, do `plan.md`, do `gate-checklist.md` e do `pull-request.md`. A pessoa apaga à mão quando quiser.
+- **Publicar (push + MR/PR) só com a escolha "Revisar o texto e publicar" (depois da aprovação do texto) ou "Publicar sem revisar o texto"** da Fase 0 (`eng.transitions-rules.md`). Com "Só gerar os arquivos", o arquivo fica na sessão e nada é enviado.
+- **A sessão nunca é apagada por este comando:** o `/eng.spec-consolidate`, que roda depois do merge, precisa do `architecture.md`, do `plan.md`, do `gate-checklist.md` e do `pull-request.md`. A pessoa apaga à mão quando quiser.
 
 ## daily.md (registro do esforço)
 
-- Gerado na Conclusão do `eng.pr`, em `$SESSIONS_DIR/eng/{TASK_MANAGER_KEY}/daily.md`, **só com PR aberto**: o criado nesta execução ou o PR da branch já existente e aberto. Sem PR aberto, não gerar.
+- Gerado na Conclusão do `eng.pr`, em `$SESSIONS_DIR/eng/{TASK_MANAGER_KEY}/daily.md`, **com ou sem PR publicado**, para não passar batido quando o PR é aberto à mão. Se houver PR (o criado nesta execução ou o já aberto da branch), preencher o campo `pr`; sem PR, deixá-lo vazio.
 - **Sempre perguntar a data** (hoje ou retroativa) com `AskUserQuestion`.
 - **Período de mais de um dia:** antes de contar os dias trabalhados, perguntar sobre sábado/domingo trabalhados, feriados e outros dias não trabalhados (o usuário informa as datas).
 - ***Post mortem*:** automático com `tipo: bugfix|hotfix` no `context.md` ou com mais de 1 dia trabalhado; nos outros casos, perguntar Sim/Não.