jarvis-ai-framework 2.1.0 → 3.0.0

package/bin/lib/cli/program.js

@@ -0,0 +1,219 @@
+/**
+ * @fileoverview Monta o `program` do commander — único lugar que precisa mudar
+ * para adicionar, remover ou alterar um comando do CLI `jarvis`.
+ *
+ * Os arquivos de `bin/commands/*.js` continuam puros: cada um exporta uma
+ * função `async (flags) => {...}` sem saber nada sobre commander. Este módulo
+ * só traduz as opções do commander (camelCase: `--env-file` -> `envFile`)
+ * para o formato antigo que essas funções já esperam (`flags["env-file"]`,
+ * `flags._` para positionals) — ver `architecture.md` da sessão `eng/72`,
+ * Decisão 3.3.
+ * @module cli/program
+ */
+
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { Command } from "commander";
+
+import { init } from "../../commands/init.js";
+import { list } from "../../commands/list.js";
+import { info } from "../../commands/info.js";
+import { whoami } from "../../commands/whoami.js";
+import { docsSync } from "../../commands/docs-sync.js";
+import { docsPublish } from "../../commands/docs-publish.js";
+import { qaSignoff } from "../../commands/qa-signoff.js";
+import { installRtk } from "../../commands/install-rtk.js";
+import { tokens } from "../../commands/tokens.js";
+import { map } from "../../commands/map.js";
+import { runCreateMerge } from "../vcs/create-merge.js";
+import { runCreateIssue } from "../vcs/create-issue.js";
+import { runFetchRaw } from "../vcs/fetch-raw.js";
+import { runComment } from "../tasks/comment.js";
+import { fetchFile } from "../docs/fetch-file.js";
+import { formatIDEsList } from "../config/ide-config.js";
+import { showBanner } from "../utils/ui.js";
+import { withEnvOptions, withLogOptions } from "./shared-options.js";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+function getVersion() {
+  const packageJson = JSON.parse(readFileSync(join(__dirname, "../../../package.json"), "utf-8"));
+  return packageJson.version;
+}
+
+/**
+ * Remonta as opções do commander (camelCase) no formato antigo de `flags`
+ * que `bin/commands/*.js` espera. `extra` (positionals, `logout: true`, etc.)
+ * é aplicado por último e sempre vence.
+ * @param {Record<string, unknown>} options
+ * @param {Record<string, unknown>} [extra]
+ */
+function toLegacyFlags(options, extra = {}) {
+  const { envFile, maxAge, ...rest } = options;
+  const flags = { ...rest };
+  if (envFile !== undefined) flags["env-file"] = envFile;
+  if (maxAge !== undefined) flags["max-age"] = maxAge;
+  return { ...flags, ...extra };
+}
+
+/**
+ * `parent.command(name)` + `allowUnknownOption()` + `allowExcessArguments()`.
+ * O commander não propaga essas duas configurações do pai para os
+ * subcomandos — precisa repetir em cada um para manter a mesma
+ * permissividade do parser manual antigo, que nunca validava flag nem
+ * contava argumentos (ver `architecture.md` da sessão `eng/72`, Decisão 3.4).
+ * @param {Command} parent
+ * @param {string} name
+ */
+function cmd(parent, name) {
+  return parent.command(name).allowUnknownOption().allowExcessArguments();
+}
+
+/** @returns {Command} */
+export function buildProgram() {
+  const program = new Command("jarvis")
+    .description("Framework Jarvis para desenvolvimento assistido por IA")
+    .version(getVersion(), "-v, --version", "Versão instalada")
+    .allowUnknownOption() // o parser antigo nunca validava flags — mantém a mesma permissividade
+    .allowExcessArguments()
+    .showHelpAfterError(true);
+
+  program.addHelpText("beforeAll", () => {
+    showBanner();
+    return "";
+  });
+  program.addHelpText("after", () => `\nIDEs Suportadas:\n  ${formatIDEsList()}\n`);
+
+  const initCmd = cmd(program, "init")
+    .description("Bootstrap do framework no workspace")
+    .option("--ide <ide>", "IDE a configurar (pula o menu interativo)")
+    .option("--force", "Sobrescreve a instalação existente sem perguntar");
+  withLogOptions(initCmd).action((options) => init(toLegacyFlags(options)));
+
+  cmd(program, "list")
+    .alias("ls")
+    .description("Listar agents, skills & workflows")
+    .argument("[type]", "Filtra por tipo: agent, skill ou workflow")
+    .option("--type <type>", "Mesmo filtro que o positional acima")
+    .action((type, options) => list(toLegacyFlags(options, { _: [type].filter(Boolean) })));
+
+  cmd(program, "info")
+    .description("Detalhes de um prompt")
+    .argument("[target]", "Ex: agent/eng.agent, skill/eng-backend")
+    .action((target) => info(target));
+
+  const whoamiCmd = cmd(program, "whoami").description("Exibir identidade (ENV.md / git / SO)");
+  withEnvOptions(withLogOptions(whoamiCmd)).action((options) => whoami(toLegacyFlags(options)));
+
+  const logoutCmd = cmd(program, "logout").description("Remover auth.json legado");
+  withLogOptions(logoutCmd).action((options) => whoami(toLegacyFlags(options, { logout: true })));
+
+  const docs = cmd(program, "docs").description("Sincronizar ou publicar documentação");
+
+  const docsSyncCmd = cmd(docs, "sync").description(
+    "Sincronizar docs do central-docs (usado por /warm-up)"
+  );
+  withEnvOptions(withLogOptions(docsSyncCmd)).action((options) => docsSync(toLegacyFlags(options)));
+
+  cmd(docs, "fetch")
+    .description(
+      "Buscar um arquivo do central-docs, com cache Redis best-effort (lê CENTRAL_DOCS_REPO do ambiente)"
+    )
+    .argument("<file-path>", "Path do arquivo dentro do repo central-docs")
+    .argument("[ref]", "Branch/ref", "main")
+    .action(async (filePath, ref) => {
+      try {
+        const content = await fetchFile(filePath, ref);
+        process.stdout.write(content);
+      } catch (error) {
+        console.error(error.message);
+        process.exit(error.code === 404 ? 2 : 1);
+      }
+    });
+
+  const docsPublishCmd = cmd(docs, "publish")
+    .description("Publicar documento no central-docs (branch + MR/PR)")
+    .option("--file <path>", "Caminho do arquivo local")
+    .option("--tipo <tipo>", "prd|frd|ard|rfc|swagger|qa-report")
+    .option("--feature <slug>", "Slug da feature (kebab-case)")
+    .option("--squad <squad>", "Override do SQUAD do ENV.md")
+    .option("--workspace <workspace>", "Override do WORKSPACE do ENV.md");
+  withEnvOptions(withLogOptions(docsPublishCmd)).action((options) =>
+    docsPublish(toLegacyFlags(options))
+  );
+
+  const installRtkCmd = cmd(program, "install-rtk").description(
+    "Instalar RTK (token killer — economia 60-90% em tokens de shell)"
+  );
+  withLogOptions(installRtkCmd).action((options) => installRtk(toLegacyFlags(options)));
+
+  const qaSignoffCmd = cmd(program, "qa-signoff")
+    .description("Verificar sign-off QA válido para a branch atual (usado pelo CI)")
+    .option("--branch <branch>", "Branch a verificar (padrão: lido do git)")
+    .option("--max-age <horas>", "Validade máxima em horas (padrão: 24)");
+  withEnvOptions(qaSignoffCmd).action((options) => qaSignoff(toLegacyFlags(options)));
+
+  cmd(program, "tokens")
+    .description("Estimar o que carrega no início da sessão")
+    .option("--hub <hub>")
+    .option("--position <position>")
+    .option("--area <area>")
+    .option("--squad <squad>")
+    .option("--rtk", "Força RTK ligado (padrão: lido do ENV.md)")
+    .option("--json", "Saída em JSON")
+    .option("--ide <ide>")
+    .option("--env-file <path>")
+    .action((options) => tokens(toLegacyFlags(options)));
+
+  cmd(program, "map")
+    .description("Mapa de chamadas de um workflow, skill ou agente")
+    .argument("[name]", "Nome do workflow, skill ou agente")
+    .option("--depth <n>", "Profundidade máxima")
+    .option("--reverse", "Mostra quem chama, em vez do que é chamado")
+    .action((name, options) => map(toLegacyFlags(options, { _: [name].filter(Boolean) })));
+
+  const vcs = cmd(program, "vcs").description("Adapters de Git host (GitLab/GitHub/Bitbucket)");
+
+  cmd(vcs, "create-merge")
+    .description("Abrir um MR/PR")
+    .option("--source <branch>")
+    .option("--target <branch>")
+    .option("--title <titulo>")
+    .option("--body-file <path>")
+    .option("--repo <url>", "Padrão: git remote get-url origin")
+    .action((options) =>
+      runCreateMerge({
+        source: options.source,
+        target: options.target,
+        title: options.title,
+        bodyFile: options.bodyFile,
+        repo: options.repo,
+      })
+    );
+
+  cmd(vcs, "create-issue")
+    .description("Abrir uma issue")
+    .option("--repo <url-ou-path>")
+    .option("--title <titulo>")
+    .option("--body-file <path>")
+    .action((options) =>
+      runCreateIssue({ repo: options.repo, title: options.title, bodyFile: options.bodyFile })
+    );
+
+  cmd(vcs, "fetch-raw")
+    .description("Buscar o conteúdo bruto de um arquivo no central-docs (lê CENTRAL_DOCS_REPO)")
+    .argument("[file-path]")
+    .argument("[ref]", "Branch/ref", "main")
+    .action((filePath, ref) => runFetchRaw(filePath, ref));
+
+  const tasks = cmd(program, "tasks").description("Adapters de task manager");
+
+  cmd(tasks, "comment")
+    .description("Comentar num card (Jira/Linear/GitHub/Asana — lê TASK_MANAGER do ENV.md)")
+    .argument("[card-key]")
+    .argument("[message...]", "Texto do comentário (pode ter espaços)")
+    .action((cardKey, messageParts) => runComment(cardKey, messageParts.join(" ")));
+
+  return program;
+}

package/bin/lib/cli/shared-options.js

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Opções do commander repetidas entre vários comandos — evita
+ * reescrever `.option(...)` em cada registro de `program.js`.
+ * @module cli/shared-options
+ */
+
+/**
+ * `--ide`/`--env-file`, usados por todo comando que resolve o ENV.md
+ * (via `env-loader.js#resolveEnvPath`).
+ * @param {import("commander").Command} cmd
+ * @returns {import("commander").Command}
+ */
+export function withEnvOptions(cmd) {
+  return cmd
+    .option("--ide <ide>", "IDE alvo (ex: claude, windsurf, cursor)")
+    .option("--env-file <path>", "Path explícito do ENV.md");
+}
+
+/**
+ * `-q/--quiet`, `-v/--verbose`, `--silent` — lidos por `logger.js#configureFromFlags`.
+ * @param {import("commander").Command} cmd
+ * @returns {import("commander").Command}
+ */
+export function withLogOptions(cmd) {
+  return cmd
+    .option("-q, --quiet", "Só mostra erros")
+    .option("-v, --verbose", "Mostra detalhes extras (nível debug)")
+    .option("--silent", "Não mostra nada, nem erros");
+}

package/bin/lib/config/constants.js

@@ -19,6 +19,7 @@ export const SYNC_DIRS = Object.freeze([
   "workflows",
   "templates",
   "rules",
+  "rules-on-demand",
   "scripts",
 ]);
 
@@ -67,6 +68,74 @@ export const OBSOLETE_PATHS = Object.freeze([
   "skills/report-issue",
   "skills/docs-central",
   "skills/docs-index",
+  // eng.downstream-flow-rules (removida): processo de board de um time, acoplado a Jira
+  "rules/engineering/eng.downstream-flow-rules.md",
+  // rules de uma etapa só: saíram de rules/ (carregada no início) para rules-on-demand/ (lida pelo workflow)
+  "rules/engineering/eng.start-rules.md",
+  "rules/engineering/eng.plan-rules.md",
+  "rules/engineering/eng.work-rules.md",
+  "rules/engineering/eng.pr-rules.md",
+  "rules/engineering/eng.pre-pr-rules.md",
+  "rules/engineering/eng.tech-spec-rules.md",
+  "rules/engineering/eng.breakdown-subtasks-rules.md",
+  // Consolidação de QA (removidos): área QA ficou só com eng-qa (base) e eng-qa-planner
+  "skills/eng-qa-test-plan",
+  "skills/eng-qa-gate",
+  "skills/eng-qa-cypress-e2e",
+  "skills/eng-qa-dev-guide",
+  "skills/eng-qa-exploratory",
+  "skills/eng-qa-bug-report",
+  "skills/eng-qa-quality-report",
+  "skills/eng-qa-testsprite",
+  "skills/eng-qa-a11y-audit",
+  "skills/eng-qa-graphql-contract",
+  "skills/eng-qa-e2e-spec-writer",
+  "skills/eng-qa-e2e",
+  "skills/eng-qa-unit-test",
+  "workflows/engineering/qa/eng.qa-dev-quality-guide.md",
+  "workflows/engineering/qa/eng.qa-e2e-test-generation.md",
+  "workflows/engineering/qa/eng.qa-exploratory-session.md",
+  "workflows/engineering/qa/eng.qa-quality-gate-validation.md",
+  "workflows/engineering/qa/eng.qa-quality-report.md",
+  "rules/engineering/qa/eng.qa.exploratory-session-rules.md",
+  "rules/engineering/qa/eng.qa.quality-gate-scoring-rules.md",
+  "rules/engineering/qa/eng.qa.tech-spec-validation-criteria-rules.md",
+  "templates/engineering/qa/eng.qa.quality-gate-examples-template.md",
+  "templates/engineering/qa/eng.qa.quality-gate-report-template.md",
+  "templates/engineering/qa/qa.cypress-test-template.md",
+  "templates/engineering/qa/qa.exploratory-session-template.md",
+  "templates/engineering/qa/qa.quality-report-template.md",
+  // Descontinuação da área security (removidos): segurança de app fica em eng-backend/eng-frontend,
+  // segurança de infra e fundamentos entram em eng-platform ou em PLATFORM_SPECIALIZATIONS
+  "skills/eng-security-cybersecurity",
+  "skills/eng-security-threat-model",
+  "skills/eng-security-triage",
+  "skills/eng-security-patch",
+  "agents/engineering/eng.cybersecurity.agent.md",
+  "workflows/engineering/eng.security-review.md",
+  "workflows/engineering/eng.security-incident.md",
+  "workflows/engineering/eng.security-audit.md",
+  "workflows/engineering/eng.security-pipeline.md",
+  // eng-automation-robot-builder (removido): conversão de fluxo manual em robô Playwright
+  // via Stagehand — sem skill de substituição hoje
+  "skills/eng-automation-robot-builder",
+  // eng-ai-engineer (removido): virou a base neutra eng-ai (padrão eng-backend, com references/)
+  "skills/eng-ai-engineer",
+  // Consolidação de data (removidos): área data ficou só com a base eng-data (padrão eng-backend)
+  "skills/eng-data-engineer",
+  "skills/eng-data-bi",
+  "skills/eng-data-debug",
+  "skills/eng-data-onboard",
+  "skills/eng-data-orchestrator",
+  // eng-global-browser-extension-builder (removido): sem uso real no framework
+  "skills/eng-global-browser-extension-builder",
+  // eng-devops-performance-engineer (removido): profiling, load testing/chaos e cache
+  // multi-camada entraram no eng-platform (temas 14, 15, 16)
+  "skills/eng-devops-performance-engineer",
+  // eng-frontend-design-system e eng-frontend-microfrontend (removidos): princípios agnósticos
+  // entraram na base eng-frontend (temas 13, 14)
+  "skills/eng-frontend-design-system",
+  "skills/eng-frontend-microfrontend",
 ]);
 
 /**
@@ -95,7 +164,7 @@ export const OPENCODE_MODEL_MAP = Object.freeze({
   "gpt-4.1": "openai/gpt-4.1",
   "gpt-4.1-mini": "openai/gpt-4.1-mini",
   "gpt-4.1-nano": "openai/gpt-4.1-nano",
-  "o3": "openai/o3",
+  o3: "openai/o3",
   "o3-mini": "openai/o3-mini",
   "o4-mini": "openai/o4-mini",
   // Google
@@ -167,4 +236,3 @@ export const KIRO_HUB_FILE_PATTERNS = Object.freeze({
   DATA: "**/*.py,**/*.sql,**/*.ipynb",
   AI: "**/*.ts,**/*.py",
 });
-

package/bin/lib/config/ide-config.js

@@ -111,25 +111,21 @@ function _validateIDEConfig(config) {
     throw new Error(`IDE config inválida: 'name' é obrigatório (string)`);
   }
   if (!config.value || typeof config.value !== "string") {
-    throw new Error(
-      `IDE config inválida: 'value' é obrigatório (string) para ${config.name}`,
-    );
+    throw new Error(`IDE config inválida: 'value' é obrigatório (string) para ${config.name}`);
   }
   if (typeof config.supported !== "boolean") {
-    throw new Error(
-      `IDE config inválida: 'supported' é obrigatório (boolean) para ${config.name}`,
-    );
+    throw new Error(`IDE config inválida: 'supported' é obrigatório (boolean) para ${config.name}`);
   }
   if (!config.workflowsFolder || typeof config.workflowsFolder !== "string") {
     throw new Error(
-      `IDE config inválida: 'workflowsFolder' é obrigatório (string) para ${config.name}`,
+      `IDE config inválida: 'workflowsFolder' é obrigatório (string) para ${config.name}`
     );
   }
   // Validar valores conhecidos
   const knownFolders = [DEFAULT_WORKFLOWS_FOLDER, COMMANDS_FOLDER, STEERING_FOLDER];
   if (!knownFolders.includes(config.workflowsFolder)) {
     logger.warn(
-      `⚠️  Atenção: IDE '${config.name}' usa workflowsFolder customizado: '${config.workflowsFolder}'`,
+      `⚠️  Atenção: IDE '${config.name}' usa workflowsFolder customizado: '${config.workflowsFolder}'`
     );
   }
 }

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

@@ -0,0 +1,116 @@
+/**
+ * @fileoverview Filtro de rules por perfil (bloco "Applies to").
+ *
+ * Espelha em JS a lógica do Passo 8 ("Profile-Aware Rules Sync") do skill
+ * `skills/jarvis-init/SKILL.md`, que é executada pela IA. As duas fontes da
+ * regra são esse passo e a seção "Profile-Aware Rules Loading" de
+ * `rules/AGENTS.md`: ao mudar uma, mude as três.
+ *
+ * Regras:
+ * - Os quatro eixos (HUB, POSITION, AREA, SQUAD) são combinados com AND.
+ * - `all` casa qualquer valor; listas são separadas por vírgula.
+ * - FULLCYCLE (HUB) satisfaz qualquer HUB.
+ * - GENERALIST (POSITION) satisfaz qualquer POSITION e qualquer AREA.
+ * - Arquivo sem bloco "Applies to" é universal.
+ * - `rules/AGENTS.md` nunca é filtrado.
+ * - `rtk-rules.md` só entra com RTK habilitado (opt-in).
+ * @module core/profile-filter
+ */
+
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+
+const APPLIES_TO_RE =
+  /> \*\*Applies to:\*\* HUB: ([^|]+)\| POSITION: ([^|]+)\| AREA: ([^|]+)\| SQUAD: (.+)/;
+
+/**
+ * @typedef {Object} AppliesTo
+ * @property {string} HUB
+ * @property {string} POSITION
+ * @property {string} AREA
+ * @property {string} SQUAD
+ */
+
+/**
+ * @typedef {Object} Profile
+ * @property {string} HUB
+ * @property {string} POSITION
+ * @property {string} AREA
+ * @property {string} SQUAD
+ */
+
+/**
+ * Lê o primeiro bloco "Applies to" do conteúdo.
+ * @param {string} content
+ * @returns {AppliesTo | null} `null` quando não há bloco (arquivo universal)
+ */
+export function parseAppliesTo(content) {
+  const match = content.match(APPLIES_TO_RE);
+  if (!match) return null;
+  return {
+    HUB: match[1].trim(),
+    POSITION: match[2].trim(),
+    AREA: match[3].trim(),
+    SQUAD: match[4].trim(),
+  };
+}
+
+function axisMatches(list, value) {
+  if (list.toLowerCase() === "all") return true;
+  return list
+    .split(",")
+    .map((s) => s.trim())
+    .includes(value);
+}
+
+/**
+ * Decide se um bloco "Applies to" casa com o perfil.
+ * @param {AppliesTo | null} appliesTo
+ * @param {Profile} profile
+ * @returns {boolean}
+ */
+export function matchesProfile(appliesTo, profile) {
+  if (!appliesTo) return true;
+  const hub = profile.HUB === "FULLCYCLE" || axisMatches(appliesTo.HUB, profile.HUB);
+  const generalist = profile.POSITION === "GENERALIST";
+  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;
+}
+
+function walkMarkdown(dir) {
+  return readdirSync(dir).flatMap((name) => {
+    const p = join(dir, name);
+    if (statSync(p).isDirectory()) return walkMarkdown(p);
+    return p.endsWith(".md") ? [p] : [];
+  });
+}
+
+/**
+ * Lista as rules que o perfil recebe, com o tamanho em bytes.
+ * @param {string} rulesDir - Pasta `rules/` do framework
+ * @param {Profile} profile
+ * @param {{ rtkEnabled?: boolean }} [opts]
+ * @returns {Array<{ path: string, bytes: number }>} Ordenado do maior para o menor;
+ *   `path` é relativo a `rulesDir`, com `/` como separador
+ */
+export function listRulesForProfile(rulesDir, profile, opts = {}) {
+  if (!existsSync(rulesDir)) return [];
+  const result = [];
+  for (const file of walkMarkdown(rulesDir)) {
+    const rel = relative(rulesDir, file).split(sep).join("/");
+    const content = readFileSync(file, "utf-8");
+    const bytes = Buffer.byteLength(content, "utf-8");
+
+    if (rel === "AGENTS.md") {
+      result.push({ path: rel, bytes });
+      continue;
+    }
+    if (rel.endsWith("rtk-rules.md") && !opts.rtkEnabled) continue;
+    if (matchesProfile(parseAppliesTo(content), profile)) {
+      result.push({ path: rel, bytes });
+    }
+  }
+  return result.sort((a, b) => b.bytes - a.bytes || a.path.localeCompare(b.path));
+}

package/bin/lib/core/scanner.js

@@ -1,41 +1,19 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { getFrameworkRoot } from "../utils/paths.js";
-
-function parseFrontmatter(content) {
-  const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
-  if (!match) return {};
-
-  const fm = {};
-  for (const line of match[1].split("\n")) {
-    const kv = line.match(/^(\w[\w-]*):\s*(.+)$/);
-    if (kv) {
-      let val = kv[2].trim();
-      if (
-        (val.startsWith('"') && val.endsWith('"')) ||
-        (val.startsWith("'") && val.endsWith("'"))
-      ) {
-        val = val.slice(1, -1);
-      }
-      fm[kv[1]] = val;
-    }
-  }
-  return fm;
-}
+import { parseFrontmatter } from "../utils/frontmatter.js";
 
 function extractDeps(content) {
   const deps = { rules: [], templates: [], skills: [], agents: [] };
 
-  const ruleFile = content.match(/rules_file:\s*"?\$IDE\/rules\/(.+?)\.md"?/);
+  const ruleFile = content.match(/rules_file:\s*"?\$IDE\/rules(?:-on-demand)?\/(.+?)\.md"?/);
   if (ruleFile) deps.rules.push(ruleFile[1]);
 
-  for (const m of content.matchAll(/rules\/([\w./-]+)\.md/g)) {
+  for (const m of content.matchAll(/rules(?:-on-demand)?\/([\w./-]+)\.md/g)) {
     if (!deps.rules.includes(m[1])) deps.rules.push(m[1]);
   }
 
-  const tplFile = content.match(
-    /template_file:\s*"?\$IDE\/templates\/(.+?)\.md"?/,
-  );
+  const tplFile = content.match(/template_file:\s*"?\$IDE\/templates\/(.+?)\.md"?/);
   if (tplFile) deps.templates.push(tplFile[1]);
 
   const agentFile = content.match(/agent:\s*"?\$IDE\/agents\/(.+?)\.md"?/);
@@ -75,11 +53,7 @@ function scanDir(dir, type) {
       continue;
     }
 
-    if (
-      !entry.name.endsWith(".md") ||
-      entry.name === "README.md" ||
-      entry.name === "AGENTS.md"
-    ) {
+    if (!entry.name.endsWith(".md") || entry.name === "README.md" || entry.name === "AGENTS.md") {
       continue;
     }
 

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

@@ -12,6 +12,7 @@ import { execSync } from "node:child_process";
 import { join, relative, basename } from "node:path";
 import { getFrameworkRoot } from "../utils/paths.js";
 import { getIDEFolder } from "../config/ide-config.js";
+import { extractFrontmatterBlock } from "../utils/frontmatter.js";
 import {
   SYNC_DIRS,
   SYNC_ROOT_FILES,
@@ -30,12 +31,11 @@ import {
  * @returns {{ name: string, description: string } | null}
  */
 function parseSkillFrontmatter(content) {
-  const match = content.match(/^---\n([\s\S]*?)\n---/);
-  if (!match) return null;
-  const fm = match[1];
+  const fm = extractFrontmatterBlock(content);
+  if (fm === null) return null;
   const name = (fm.match(/^name:\s*(.+)$/m) || [])[1]?.trim();
   // description pode ser multiline com `>`
-  const descMatch = fm.match(/^description:\s*[>|]?\n?([\s\S]*?)(?=\n\S|\n---|\Z)/m);
+  const descMatch = fm.match(/^description:\s*[>|]?\n?([\s\S]*?)(?=\n\S|\n---|Z)/m);
   const description = descMatch
     ? descMatch[1].replace(/^\s+/gm, "").replace(/\n+/g, " ").trim()
     : "";
@@ -59,8 +59,7 @@ function generateCodexOpenAIYaml(skillsDir) {
     const parsed = parseSkillFrontmatter(content);
     if (!parsed) continue;
     const yaml =
-      `name: ${parsed.name}\n` +
-      `description: "${parsed.description.replace(/"/g, '\\"')}"\n`;
+      `name: ${parsed.name}\n` + `description: "${parsed.description.replace(/"/g, '\\"')}"\n`;
     writeFileSync(yamlPath, yaml, "utf-8");
   }
 }
@@ -77,9 +76,7 @@ export function syncAssets(targetDir, ide, opts = {}) {
   for (const dir of SYNC_DIRS) {
     const src = join(frameworkRoot, dir);
     // Se for "workflows" e a IDE usa outro nome, usa o nome configurado
-    const destDirName = (dir === "workflows" && opts.workflowsFolder)
-      ? opts.workflowsFolder
-      : dir;
+    const destDirName = dir === "workflows" && opts.workflowsFolder ? opts.workflowsFolder : dir;
     const dest = join(ideDir, destDirName);
 
     if (!existsSync(src)) {
@@ -246,7 +243,8 @@ function resolveOpenCodeModel(model) {
   if (OPENCODE_MODEL_MAP[trimmed]) return OPENCODE_MODEL_MAP[trimmed];
   // Inferir provider pelo prefixo do modelo
   if (trimmed.startsWith("claude")) return `anthropic/${trimmed}`;
-  if (trimmed.startsWith("gpt") || trimmed.startsWith("o3") || trimmed.startsWith("o4")) return `openai/${trimmed}`;
+  if (trimmed.startsWith("gpt") || trimmed.startsWith("o3") || trimmed.startsWith("o4"))
+    return `openai/${trimmed}`;
   if (trimmed.startsWith("gemini")) return `google/${trimmed}`;
   // Fallback: retornar sem provider — OpenCode resolverá pelo provider padrão
   return trimmed;
@@ -370,11 +368,16 @@ function flattenDir(dir, rootDir) {
     const fullPath = join(dir, entry.name);
     if (entry.isDirectory()) {
       moved += flattenDir(fullPath, root);
-      try { rmSync(fullPath, { recursive: true, force: true }); } catch {}
+      try {
+        rmSync(fullPath, { recursive: true, force: true });
+      } catch {}
     } else if (entry.isFile() && entry.name.endsWith(".md")) {
       const dest = join(root, basename(entry.name));
       if (fullPath !== dest) {
-        try { renameSync(fullPath, dest); moved++; } catch {}
+        try {
+          renameSync(fullPath, dest);
+          moved++;
+        } catch {}
       }
     }
   }
@@ -402,9 +405,13 @@ function toKiroSteeringFile(content, inclusion, fileMatchPattern) {
 
   if (fmMatch) {
     const fm = fmMatch[1];
-    const description = (fm.match(/^description:\s*[>|]?\s*\n?([\s\S]*?)(?=\n\S|\n---|\Z)/m) || [])[1];
+    const description = (fm.match(/^description:\s*[>|]?\s*\n?([\s\S]*?)(?=\n\S|\n---|Z)/m) ||
+      [])[1];
     const descInline = (fm.match(/^description:\s*(.+)$/m) || [])[1];
-    const finalDesc = (description || descInline || "").replace(/^\s+/gm, "").replace(/\n+/g, " ").trim();
+    const finalDesc = (description || descInline || "")
+      .replace(/^\s+/gm, "")
+      .replace(/\n+/g, " ")
+      .trim();
     if (finalDesc) lines.push(`description: "${finalDesc.replace(/"/g, '\\"')}"`);
   }