jarvis-ai-framework 1.0.0

package/bin/commands/qa-signoff.js

@@ -0,0 +1,112 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { loadEnv, resolveEnvPath } from '../lib/env-loader.js'
+import { GREEN, RED, YELLOW, DIM, NC } from '../lib/utils/ui.js'
+import { logger } from '../lib/utils/logger.js'
+
+/**
+ * Verifica se existe um sign-off QA válido para a branch atual (ou informada).
+ * Retorna 0 (válido) ou 1 (inválido/ausente) — usado pelo CI.
+ *
+ * @param {Object} flags
+ * @param {string} flags.branch     - Branch a verificar (padrão: lido do git)
+ * @param {string} flags['max-age'] - Validade máxima em horas (padrão: 24)
+ */
+export async function qaSignoff(flags = {}) {
+  const cwd = process.cwd()
+  const maxAgeHours = parseInt(flags['max-age'] ?? '24', 10)
+
+  // Resolver branch
+  let branch = flags.branch
+  if (!branch) {
+    try {
+      const { execSync } = await import('node:child_process')
+      branch = execSync('git branch --show-current', { cwd, encoding: 'utf-8' }).trim()
+    } catch {
+      logger.error(`${RED}❌ Não foi possível detectar a branch atual.${NC}`)
+      logger.info(`${YELLOW}Passe a branch via --branch <nome>${NC}`)
+      process.exit(1)
+    }
+  }
+
+  if (!branch) {
+    logger.error(`${RED}❌ Branch não identificada.${NC}`)
+    process.exit(1)
+  }
+
+  // Carregar ENV.md para descobrir DOCS_FOLDER
+  let docsFolder = 'docs'
+  try {
+    const resolved = resolveEnvPath(cwd, flags)
+    const env = loadEnv(cwd, resolved.path)
+    if (env.DOCS_FOLDER) docsFolder = env.DOCS_FOLDER
+  } catch {
+    // Se não encontrar ENV.md, usa default
+  }
+
+  const signoffsDir = join(cwd, docsFolder, 'engineering', 'qa', 'signoffs')
+
+  if (!existsSync(signoffsDir)) {
+    logger.error(`${RED}❌ Nenhum sign-off QA encontrado para a branch: ${branch}${NC}`)
+    logger.info(`${YELLOW}Execute o workflow qa.release-signoff antes do deploy.${NC}`)
+    process.exit(1)
+  }
+
+  // Normalizar slug da branch para busca nos nomes de arquivo
+  const branchSlug = branch.replace(/\//g, '-').replace(/[^a-zA-Z0-9-_]/g, '-')
+
+  // Buscar arquivos de sign-off que correspondam à branch
+  const files = readdirSync(signoffsDir)
+    .filter(f => f.endsWith('.md') && f.includes(branchSlug))
+    .sort()
+    .reverse() // mais recente primeiro
+
+  if (files.length === 0) {
+    logger.error(`${RED}❌ Nenhum sign-off QA encontrado para a branch: ${branch}${NC}`)
+    logger.info(`${YELLOW}Execute o workflow qa.release-signoff antes do deploy.${NC}`)
+    process.exit(1)
+  }
+
+  // Ler o sign-off mais recente
+  const latestFile = files[0]
+  const filePath = join(signoffsDir, latestFile)
+  const content = readFileSync(filePath, 'utf-8')
+
+  // Extrair frontmatter
+  const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/)
+  if (!frontmatterMatch) {
+    logger.error(`${RED}❌ Sign-off inválido: frontmatter ausente em ${latestFile}${NC}`)
+    process.exit(1)
+  }
+
+  const frontmatter = frontmatterMatch[1]
+  const statusMatch = frontmatter.match(/^status:\s*(.+)$/m)
+  const dateMatch = frontmatter.match(/^date:\s*(.+)$/m)
+
+  const status = statusMatch?.[1]?.trim().replace(/['"]/g, '') ?? ''
+  const dateStr = dateMatch?.[1]?.trim().replace(/['"]/g, '') ?? ''
+
+  // Verificar status
+  if (status.toUpperCase() !== 'GO') {
+    logger.error(`${RED}❌ Sign-off com status ${status} — deploy bloqueado.${NC}`)
+    logger.info(`${DIM}Arquivo: ${latestFile}${NC}`)
+    process.exit(1)
+  }
+
+  // Verificar validade (max-age)
+  if (dateStr) {
+    const signoffDate = new Date(dateStr)
+    const now = new Date()
+    const ageHours = (now - signoffDate) / (1000 * 60 * 60)
+
+    if (ageHours > maxAgeHours) {
+      logger.error(`${RED}❌ Sign-off expirado: criado há ${Math.round(ageHours)}h (máximo: ${maxAgeHours}h).${NC}`)
+      logger.info(`${YELLOW}Execute qa.release-signoff novamente antes do deploy.${NC}`)
+      process.exit(1)
+    }
+  }
+
+  logger.info(`${GREEN}✅ Sign-off QA válido para branch: ${branch}${NC}`)
+  logger.info(`${DIM}Arquivo: ${latestFile} | Status: GO | Válido por mais ${Math.round(maxAgeHours - ((new Date() - new Date(dateStr)) / (1000 * 60 * 60)))}h${NC}`)
+  process.exit(0)
+}

package/bin/commands/whoami.js

@@ -0,0 +1,43 @@
+import { resolveUser, readSession, clearSession } from '../lib/auth/session.js'
+import { loadEnv, resolveEnvPath } from '../lib/env-loader.js'
+import { logger, configureFromFlags } from '../lib/utils/logger.js'
+import { GREEN, YELLOW, BLUE, DIM, NC } from '../lib/utils/ui.js'
+
+export async function whoami(flags) {
+  configureFromFlags(flags)
+
+  if (flags.logout) {
+    clearSession()
+    logger.info(`${GREEN}✓ ~/.jarvis/auth.json removido${NC}`)
+    logger.info(`${DIM}Login não é mais necessário — identidade vem de USER= no ENV.md, git ou SO.${NC}`)
+    return
+  }
+
+  let env = {}
+  try {
+    const cwd = process.cwd()
+    const resolved = resolveEnvPath(cwd, flags)
+    env = loadEnv(cwd, resolved.path)
+  } catch {
+    // sem ENV.md ainda — resolve via git/os
+  }
+
+  const { id, source } = resolveUser(env)
+
+  logger.info('')
+  logger.info(`${BLUE}👤 Identidade${NC}`)
+  logger.info('')
+  logger.info(`  ${BLUE}USER:${NC}   ${id}`)
+  logger.info(`  ${BLUE}Fonte:${NC}  ${source}`)
+  logger.info('')
+  logger.info(`${DIM}Sem login. Ordem: ENV.md (USER=) → git config user.email → usuário do SO.${NC}`)
+
+  const leftover = readSession()
+  if (leftover?.email) {
+    logger.info('')
+    logger.info(`  ${YELLOW}⚠ ~/.jarvis/auth.json legado (${leftover.email}) — não é usado.${NC}`)
+    logger.info(`  ${DIM}Remova com: jarvis logout${NC}`)
+  }
+
+  logger.info('')
+}

package/bin/jarvis.js

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+
+import { argv, exit } from "node:process";
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+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 { formatIDEsList } from "./lib/config/ide-config.js";
+import { showBanner, BLUE, GREEN, YELLOW, DIM, NC } from "./lib/utils/ui.js";
+import { logger } from "./lib/utils/logger.js";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const args = argv.slice(2);
+const command = args[0];
+
+// Lazy loading do package.json (só quando necessário)
+let _version = null;
+function getVersion() {
+  if (_version === null) {
+    const packageJson = JSON.parse(
+      readFileSync(join(__dirname, "../package.json"), "utf-8"),
+    );
+    _version = packageJson.version;
+  }
+  return _version;
+}
+
+function help() {
+  showBanner();
+
+  logger.info(`${BLUE}📚 Ajuda${NC}\n`);
+
+  logger.info(`${YELLOW}Uso:${NC}`);
+  logger.info(
+    `  ${GREEN}jarvis init${NC} [--ide <ide>]   Bootstrap framework no workspace`,
+  );
+  logger.info(
+    `  ${GREEN}jarvis list${NC}                             Listar agents, skills & workflows`,
+  );
+  logger.info(
+    `  ${GREEN}jarvis info${NC} <type/name>                 Detalhes de um prompt`,
+  );
+  logger.info(
+    `  ${GREEN}jarvis whoami${NC}                           Exibir identidade (ENV.md / git / SO)`,
+  );
+  logger.info(
+    `  ${GREEN}jarvis logout${NC}                           Remover auth.json legado`,
+  );
+  logger.info(
+    `  ${GREEN}jarvis docs sync${NC} [--silent] [--verbose]              Sincronizar docs do central-docs`,
+  );
+  logger.info(
+    `  ${GREEN}jarvis docs publish${NC} --file <path> --tipo <tipo> --feature <slug> [--squad <squad>] [--workspace <workspace>]`,
+  );
+  logger.info(
+    `  ${GREEN}jarvis install-rtk${NC}                      Instalar RTK (token killer — economia 60-90%)`,
+  );
+  logger.info(
+    `  ${GREEN}jarvis qa-signoff${NC} [--branch <branch>] [--max-age <horas>]   Verificar sign-off QA (usado pelo CI)`,
+  );
+  logger.info(
+    `  ${GREEN}jarvis --version${NC}                        Versão instalada`,
+  );
+  logger.info("");
+
+  logger.info(`${YELLOW}IDEs Suportadas:${NC}`);
+  logger.info(`  ${formatIDEsList()}`);
+  logger.info("");
+
+  logger.info(`${YELLOW}🚀 Começar:${NC}`);
+  logger.info(
+    `  ${DIM}1.${NC} npm install -g ${GREEN}/caminho/para/jarvis${NC}`,
+  );
+  logger.info(`  ${DIM}2.${NC} ${GREEN}jarvis init${NC} --ide cursor`);
+  logger.info(`  ${DIM}3.${NC} No chat da IDE: ${GREEN}/init-jarvis${NC}`);
+  logger.info("");
+
+  logger.info(`${BLUE}📖 Exemplos:${NC}`);
+  logger.info(
+    `  ${GREEN}jarvis list${NC}                                  Listar todos os prompts`,
+  );
+  logger.info(
+    `  ${GREEN}jarvis info agent/eng${NC}                        Detalhes do agent eng`,
+  );
+  logger.info(
+    `  ${GREEN}jarvis docs sync${NC}                             Sincronizar docs do central-docs`,
+  );
+  logger.info(
+    `  ${GREEN}jarvis docs publish --file ./docs/ard.md --tipo ard --feature auth-jwt${NC}`,
+  );
+  logger.info("");
+}
+
+function parseFlags(args) {
+  const flags = {};
+  for (let i = 0; i < args.length; i++) {
+    if (args[i].startsWith("--")) {
+      const key = args[i].slice(2);
+      flags[key] =
+        args[i + 1] && !args[i + 1].startsWith("--") ? args[++i] : true;
+    } else {
+      flags._ = flags._ || [];
+      flags._.push(args[i]);
+    }
+  }
+  return flags;
+}
+
+const flags = parseFlags(args.slice(1));
+
+const commands = {
+  init: () => init(flags),
+  list: () => list(flags),
+  ls: () => list(flags),
+  info: () => info(flags._?.[0], flags),
+  logout: () => whoami({ ...flags, logout: true }),
+  whoami: () => whoami(flags),
+  docs: () => {
+    const subcommand = flags._?.[0];
+    if (subcommand === "sync") {
+      return docsSync(flags);
+    } else if (subcommand === "publish") {
+      return docsPublish(flags);
+    } else {
+      logger.error("\n  Subcomando inválido para docs\n");
+      logger.info("Uso:");
+      logger.info(`  ${GREEN}jarvis docs sync${NC} [--silent] [--verbose]`);
+      logger.info(
+        `  ${GREEN}jarvis docs publish${NC} --file <path> --tipo <prd|frd|ard|rfc> --feature <slug> [--squad <squad>] [--workspace <workspace>]`,
+      );
+      logger.info("");
+      exit(1);
+    }
+  },
+  "install-rtk": () => installRtk(flags),
+  "qa-signoff": () => qaSignoff(flags),
+  "--version": () => logger.info(getVersion()),
+  "-v": () => logger.info(getVersion()),
+  "--help": () => help(),
+  "-h": () => help(),
+};
+
+if (command in commands) {
+  await commands[command]();
+} else if (!command) {
+  help();
+} else {
+  logger.error(`\n  Unknown command: ${command}\n`);
+  help();
+  exit(1);
+}

package/bin/lib/auth/session.js

@@ -0,0 +1,56 @@
+import { existsSync, readFileSync, unlinkSync } from 'node:fs'
+import { execSync } from 'node:child_process'
+import { join } from 'node:path'
+import { homedir, userInfo } from 'node:os'
+
+const SESSION_FILE = join(homedir(), '.jarvis', 'auth.json')
+
+export function readSession() {
+  if (!existsSync(SESSION_FILE)) return null
+  try {
+    return JSON.parse(readFileSync(SESSION_FILE, 'utf-8'))
+  } catch {
+    return null
+  }
+}
+
+export function clearSession() {
+  if (existsSync(SESSION_FILE)) {
+    unlinkSync(SESSION_FILE)
+  }
+}
+
+/**
+ * Resolve local identity without OAuth.
+ * Order: ENV.md USER → git user.email → OS username → "local"
+ */
+export function resolveUser(env = {}) {
+  const envUser = typeof env.USER === 'string' ? env.USER.trim() : ''
+  if (envUser) return { id: envUser, source: 'ENV.md' }
+
+  try {
+    const email = execSync('git config --get user.email', {
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'ignore'],
+    }).trim()
+    if (email) return { id: email, source: 'git' }
+  } catch {
+    // ignore
+  }
+
+  try {
+    const username = userInfo().username
+    if (username) return { id: username, source: 'os' }
+  } catch {
+    // ignore
+  }
+
+  return { id: 'local', source: 'fallback' }
+}
+
+/**
+ * Identity used as dev_id. Never requires jarvis login.
+ */
+export function getAuthUser(env = {}) {
+  return resolveUser(env).id
+}

package/bin/lib/config/constants.js

@@ -0,0 +1,123 @@
+/**
+ * @fileoverview Constantes globais do sistema
+ * @module config/constants
+ */
+
+/** @constant {string} Nome do pacote NPM */
+export const CLI_NAME = "jarvis-framework";
+
+/** @constant {string} Nome do arquivo de lock */
+export const LOCK_FILE = "jarvis-lock.json";
+
+/**
+ * Diretórios que devem ser sincronizados do framework para a IDE
+ * @constant {ReadonlyArray<string>}
+ */
+export const SYNC_DIRS = Object.freeze([
+  "agents",
+  "skills",
+  "workflows",
+  "templates",
+  "rules",
+  "scripts",
+]);
+
+/**
+ * Arquivos da raiz que devem ser sincronizados
+ * @constant {ReadonlyArray<string>}
+ */
+export const SYNC_ROOT_FILES = Object.freeze(["taxonomy.md", "AGENTS.md", "members.md"]);
+
+/**
+ * Mapeamento de model do Jarvis para formato OpenCode (provider/model-id)
+ * @constant {Readonly<Record<string, string>>}
+ */
+export const OPENCODE_MODEL_MAP = Object.freeze({
+  // Anthropic — shorthands usados no Jarvis
+  opus: "anthropic/claude-opus-4-6",
+  sonnet: "anthropic/claude-sonnet-4-6",
+  haiku: "anthropic/claude-haiku-4-5-20250414",
+  // Anthropic — IDs completos
+  "claude-opus-4-6-20250529": "anthropic/claude-opus-4-6",
+  "claude-sonnet-4-6-20250514": "anthropic/claude-sonnet-4-6",
+  "claude-sonnet-4-20250514": "anthropic/claude-sonnet-4-6",
+  "claude-haiku-4-5-20250414": "anthropic/claude-haiku-4-5-20250414",
+  // OpenAI
+  "gpt-4o": "openai/gpt-4o",
+  "gpt-4o-mini": "openai/gpt-4o-mini",
+  "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-mini": "openai/o3-mini",
+  "o4-mini": "openai/o4-mini",
+  // Google
+  "gemini-2.5-pro": "google/gemini-2.5-pro",
+  "gemini-2.5-flash": "google/gemini-2.5-flash",
+  "gemini-2.0-flash": "google/gemini-2.0-flash",
+});
+
+/**
+ * Permissões padrão para agents OpenCode
+ * @constant {Readonly<Record<string, string>>}
+ */
+export const OPENCODE_DEFAULT_PERMISSIONS = Object.freeze({
+  edit: "allow",
+  bash: "allow",
+  read: "allow",
+  glob: "allow",
+  grep: "allow",
+  task: "allow",
+});
+
+/**
+ * Campos de frontmatter Jarvis-only que devem ser removidos para OpenCode commands
+ * @constant {ReadonlyArray<string>}
+ */
+export const OPENCODE_STRIP_FIELDS = Object.freeze([
+  "auto_execution_mode",
+  "rules_file",
+  "template_file",
+  "model_tier",
+  "model_justification",
+  "recommended_model",
+  "env_file",
+  "globs",
+]);
+
+/**
+ * Campos de frontmatter Jarvis-only que devem ser removidos para steering files Kiro
+ * @constant {ReadonlyArray<string>}
+ */
+export const KIRO_STRIP_FIELDS = Object.freeze([
+  "trigger",
+  "auto_execution_mode",
+  "rules_file",
+  "template_file",
+  "model_tier",
+  "model_justification",
+  "recommended_model",
+  "env_file",
+  "globs",
+  "agent",
+  "allowed-tools",
+  "disable-model-invocation",
+  "compatibility",
+  "license",
+  "metadata",
+  "argument-hint",
+]);
+
+/**
+ * Mapeamento de HUB Jarvis para fileMatchPattern do Kiro
+ * Usado para gerar steering files de rules com inclusion: fileMatch
+ * @constant {Readonly<Record<string, string>>}
+ */
+export const KIRO_HUB_FILE_PATTERNS = Object.freeze({
+  FRONTEND: "**/*.tsx,**/*.ts,**/*.jsx,**/*.js,**/*.css,**/*.scss",
+  BACKEND: "**/*.ts,**/*.js",
+  QA: "**/*.test.ts,**/*.spec.ts,**/*.cy.ts,**/*.test.js,**/*.spec.js",
+  DATA: "**/*.py,**/*.sql,**/*.ipynb",
+  AI: "**/*.ts,**/*.py",
+});
+