agent-master-devsecops 3.9.0 → 5.1.0

package/scripts/jira_manager.js

@@ -1,408 +0,0 @@
-#!/usr/bin/env node
-/**
- * scripts/jira_manager.js
- * 
- * Gerenciador Unificado do Jira: Padronização de Kanban, WIP Limits, Sprints e Time-Tracking.
- * Consolida o controle de fluxo ágil dos 3 Kanbans canônicos ("A fazer", "Em andamento", "Concluído")
- * com o registro automatizado de worklogs e timetracking durante o ciclo de desenvolvimento.
- * 
- * Governança: Tríade Git + Jira + Confluence (Regra 11 e AGENT_SCRUM).
- */
-
-'use strict';
-
-const fs = require('node:fs');
-const path = require('node:path');
-
-const {
-  getAtlassianCredentials,
-  requestAtlassian,
-  getGitMetadata
-} = require('./atlassian_client.js');
-
-// ==========================================
-// 1. KANBAN CANÔNICO & PADRONIZAÇÃO DE QUADRO
-// ==========================================
-
-const CANONICAL_KANBANS = Object.freeze({
-  TODO: 'A fazer',
-  IN_PROGRESS: 'Em andamento',
-  DONE: 'Concluído'
-});
-
-const CANONICAL_COLUMNS_LIST = [
-  CANONICAL_KANBANS.TODO,
-  CANONICAL_KANBANS.IN_PROGRESS,
-  CANONICAL_KANBANS.DONE
-];
-
-/**
- * Sanitiza o summary de um card do Jira, removendo chaves redundantes do título.
- * Exemplo: "[PROJ-123] Deploy de Produção" -> "Deploy de Produção"
- */
-function sanitizeIssueSummary(summary = '') {
-  if (!summary) return '';
-  return summary.replace(/^\s*\[[A-Z]{2,10}-\d+\]\s*[:-]?\s*/i, '').trim();
-}
-
-/**
- * Valida o limite de trabalho em progresso (WIP Limit).
- */
-function checkWipLimit(inProgressCount = 0, maxWip = 2) {
-  return {
-    inProgressCount,
-    maxWip,
-    isSaturated: inProgressCount >= maxWip,
-    canPullNewTask: inProgressCount < maxWip,
-    alertMessage: inProgressCount >= maxWip
-      ? `WIP SATURADO: ${inProgressCount} tarefas ativas em andamento (limite máximo: ${maxWip}). Conclua tarefas antes de puxar novas.`
-      : null
-  };
-}
-
-/**
- * Mapeia qualquer status ou nome de coluna legado do Jira para uma das 3 colunas canônicas.
- */
-function resolveCanonicalColumn(statusName = '', statusCategory = '') {
-  const normName = String(statusName).trim().toLowerCase();
-  const normCat = String(statusCategory).trim().toLowerCase();
-
-  // 1. Concluído / Done
-  if (
-    normName.includes('concl') ||
-    normName.includes('done') ||
-    normName.includes('finaliz') ||
-    normName.includes('resolv') ||
-    normCat.includes('conclu') ||
-    normCat.includes('done') ||
-    normCat.includes('complete')
-  ) {
-    return CANONICAL_KANBANS.DONE;
-  }
-
-  // 2. Em andamento / In Progress
-  if (
-    normName.includes('andamento') ||
-    normName.includes('progress') ||
-    normName.includes('desenvolv') ||
-    normName.includes('análise') ||
-    normName.includes('analise') ||
-    normCat.includes('andamento') ||
-    normCat.includes('progress') ||
-    normCat.includes('indeterminate')
-  ) {
-    return CANONICAL_KANBANS.IN_PROGRESS;
-  }
-
-  // 3. A fazer / To Do / Backlog
-  return CANONICAL_KANBANS.TODO;
-}
-
-/**
- * Normaliza e consolida as colunas de uma configuração de Board do Jira para os 3 Kanbans padrão.
- */
-function standardizeBoardColumns(boardConfig = {}) {
-  const rawColumns = (boardConfig && boardConfig.columnConfig && boardConfig.columnConfig.columns) || [];
-  
-  const standardized = {
-    canonicalColumns: [...CANONICAL_COLUMNS_LIST],
-    columns: [
-      { name: CANONICAL_KANBANS.TODO, statuses: [] },
-      { name: CANONICAL_KANBANS.IN_PROGRESS, statuses: [] },
-      { name: CANONICAL_KANBANS.DONE, statuses: [] }
-    ],
-    remappedCount: 0
-  };
-
-  const todoCol = standardized.columns[0];
-  const inProgCol = standardized.columns[1];
-  const doneCol = standardized.columns[2];
-
-  for (const col of rawColumns) {
-    const canonicalTarget = resolveCanonicalColumn(col.name);
-    const statuses = col.statuses || [];
-
-    if (canonicalTarget === CANONICAL_KANBANS.DONE) {
-      doneCol.statuses.push(...statuses);
-    } else if (canonicalTarget === CANONICAL_KANBANS.IN_PROGRESS) {
-      inProgCol.statuses.push(...statuses);
-    } else {
-      todoCol.statuses.push(...statuses);
-    }
-
-    if (col.name !== canonicalTarget) {
-      standardized.remappedCount++;
-    }
-  }
-
-  return standardized;
-}
-
-/**
- * Constrói a consulta JQL padronizada para uma das 3 colunas canônicas no Jira.
- */
-function buildCanonicalJql(projectKey, canonicalColumn) {
-  if (!projectKey) throw new Error('projectKey é obrigatório para construir JQL.');
-
-  switch (canonicalColumn) {
-    case CANONICAL_KANBANS.TODO:
-      return `project = "${projectKey}" AND statusCategory in ("To Do", "Undefined") ORDER BY rank ASC, created ASC`;
-    case CANONICAL_KANBANS.IN_PROGRESS:
-      return `project = "${projectKey}" AND statusCategory in ("In Progress") ORDER BY rank ASC, updated DESC`;
-    case CANONICAL_KANBANS.DONE:
-      return `project = "${projectKey}" AND statusCategory in ("Done") ORDER BY updated DESC`;
-    default:
-      throw new Error(`Coluna desconhecida: "${canonicalColumn}". Use: ${CANONICAL_COLUMNS_LIST.join(', ')}`);
-  }
-}
-
-/**
- * Valida se há pelo menos um sprint ativo na esteira para evitar "quadro de sprints ativo vazio".
- */
-function validateSprintHealth(sprints = []) {
-  const activeSprints = sprints.filter(s => s.state === 'active');
-  const futureSprints = sprints.filter(s => s.state === 'future');
-  const closedSprints = sprints.filter(s => s.state === 'closed');
-
-  return {
-    totalSprints: sprints.length,
-    activeCount: activeSprints.length,
-    futureCount: futureSprints.length,
-    closedCount: closedSprints.length,
-    hasActiveSprint: activeSprints.length > 0,
-    warning: activeSprints.length === 0
-      ? 'ALERTA DE FLUXO: Nenhuma sprint está ativa no Jira. A tela de Sprints Ativos ficará em branco até que uma sprint seja iniciada.'
-      : null
-  };
-}
-
-/**
- * Avalia candidato do backlog com base no contexto do projeto (Regra 14).
- */
-function evaluateFullDevCandidate(candidate, projectContext = {}) {
-  const { title = '', description = '' } = candidate;
-  const { stack = 'generic', domain = 'general' } = projectContext;
-
-  const text = `${title} ${description}`.toLowerCase();
-  const evaluation = {
-    valid: true,
-    candidateTitle: sanitizeIssueSummary(title),
-    reasons: [],
-    recommendedAction: 'PROCEED_TO_IN_PROGRESS'
-  };
-
-  const overengineeringKeywords = ['blockchain', 'smart contract', 'quantum computing', 'microservices mesh'];
-  const matchedOver = overengineeringKeywords.filter(k => text.includes(k));
-  if (matchedOver.length > 0 && !String(domain).toLowerCase().includes('crypto')) {
-    evaluation.valid = false;
-    evaluation.reasons.push(`Overengineering ou desconexão com domínio (${domain}): detectado [${matchedOver.join(', ')}]`);
-    evaluation.recommendedAction = 'DROP_OR_REJECT';
-  }
-
-  if (text.includes('kubernetes') && (stack.includes('cli') || stack.includes('desktop'))) {
-    evaluation.valid = false;
-    evaluation.reasons.push(`Incompatibilidade com stack (${stack}): infraestrutura desproporcional`);
-    evaluation.recommendedAction = 'DROP_OR_REJECT';
-  }
-
-  return evaluation;
-}
-
-/**
- * Orquestra o ciclo do Modo Full Developer baseado nos 3 Kanbans canônicos.
- */
-function processFullDevPipeline(tasks = [], projectContext = {}, maxWip = 2) {
-  const todoTasks = tasks.filter(t => resolveCanonicalColumn(t.status || t.statusName, t.statusCategory) === CANONICAL_KANBANS.TODO);
-  const inProgressTasks = tasks.filter(t => resolveCanonicalColumn(t.status || t.statusName, t.statusCategory) === CANONICAL_KANBANS.IN_PROGRESS);
-  const doneTasks = tasks.filter(t => resolveCanonicalColumn(t.status || t.statusName, t.statusCategory) === CANONICAL_KANBANS.DONE);
-
-  const wipStatus = checkWipLimit(inProgressTasks.length, maxWip);
-
-  const results = {
-    totalTasks: tasks.length,
-    counts: {
-      todo: todoTasks.length,
-      inProgress: inProgressTasks.length,
-      done: doneTasks.length
-    },
-    wipStatus,
-    activeTask: inProgressTasks[0] || null,
-    activeTasks: inProgressTasks,
-    nextApprovedTask: null,
-    rejectedTasks: [],
-    lifecyclePlan: []
-  };
-
-  if (wipStatus.isSaturated) {
-    results.lifecyclePlan.push({
-      step: 'CONCLUDE_ACTIVE_TASKS',
-      message: wipStatus.alertMessage
-    });
-    return results;
-  }
-
-  for (const candidate of todoTasks) {
-    const evalRes = evaluateFullDevCandidate(candidate, projectContext);
-    if (evalRes.valid && !results.nextApprovedTask) {
-      results.nextApprovedTask = candidate;
-      results.lifecyclePlan.push({
-        step: 'TRANSITION_AND_START',
-        taskKey: candidate.key || candidate.id,
-        cleanSummary: evalRes.candidateTitle,
-        from: CANONICAL_KANBANS.TODO,
-        to: CANONICAL_KANBANS.IN_PROGRESS,
-        message: 'Ideia/tarefa aprovada pelo filtro de sanidade (Regra 14). Transicionar para "Em andamento" e iniciar ciclo.'
-      });
-    } else if (!evalRes.valid) {
-      results.rejectedTasks.push({
-        taskKey: candidate.key || candidate.id,
-        reasons: evalRes.reasons
-      });
-    }
-  }
-
-  return results;
-}
-
-// ==========================================
-// 2. TIME TRACKING & WORKLOGS
-// ==========================================
-
-function extractIssueKeys(text) {
-  if (!text) return [];
-  const matches = text.match(/\b[A-Z]{2,10}-\d+\b/g) || [];
-  return [...new Set(matches.map(k => k.toUpperCase()))];
-}
-
-async function getExistingWorklogs(credentials, issueKey) {
-  const res = await requestAtlassian(credentials, 'GET', `/rest/api/3/issue/${issueKey}/worklog`);
-  if (res.status === 200 && res.body?.worklogs) {
-    return res.body.worklogs;
-  }
-  return [];
-}
-
-async function logWorkTime(credentials, issueKey, timeSpentSeconds, commentText) {
-  const startedTime = new Date().toISOString().replace('Z', '+0000');
-  const payload = {
-    timeSpentSeconds,
-    started: startedTime,
-    comment: {
-      type: 'doc',
-      version: 1,
-      content: [
-        {
-          type: 'paragraph',
-          content: [{ type: 'text', text: commentText }]
-        }
-      ]
-    }
-  };
-
-  return requestAtlassian(credentials, 'POST', `/rest/api/3/issue/${issueKey}/worklog`, payload);
-}
-
-async function ensureInProgress(credentials, issueKey) {
-  try {
-    const issueRes = await requestAtlassian(credentials, 'GET', `/rest/api/3/issue/${issueKey}?fields=status`);
-    if (issueRes.status === 200 && issueRes.body?.fields?.status) {
-      const currentStatus = issueRes.body.fields.status.name.toLowerCase();
-      if (currentStatus.includes('backlog') || currentStatus.includes('fazer') || currentStatus.includes('to do')) {
-        await requestAtlassian(credentials, 'POST', `/rest/api/3/issue/${issueKey}/transitions`, {
-          transition: { id: '31' }
-        });
-        console.log(`[Jira Manager] 🔄 Card ${issueKey} transicionado para "Em andamento".`);
-      }
-    }
-  } catch (err) {
-    console.warn(`[Jira Manager] Aviso ao checar status de ${issueKey}:`, err.message);
-  }
-}
-
-async function trackIssueTime(credentials, key, gitMeta) {
-  await ensureInProgress(credentials, key);
-
-  const existing = await getExistingWorklogs(credentials, key);
-  const tag = `[commit:${gitMeta.shortSha}]`;
-  const alreadyLogged = existing.some(wl => {
-    const text = JSON.stringify(wl.comment || {});
-    return text.includes(tag);
-  });
-
-  if (alreadyLogged) {
-    console.log(`[Jira Manager] ℹ Tempo já registrado anteriormente para o commit ${gitMeta.shortSha} no card ${key}.`);
-    return { key, status: 'already_logged' };
-  }
-
-  const timeSpentSeconds = 900; // 15 minutos padrão
-  const comment = `Tempo de andamento registrado automaticamente via esteira de CI/CD.\nAutor: ${gitMeta.authorName || 'DevSecOps Bot'}\nCommit: ${gitMeta.shortSha} (${gitMeta.commitMessage.split('\n')[0]})\n${tag}`;
-
-  const res = await logWorkTime(credentials, key, timeSpentSeconds, comment);
-  if (res.status === 201) {
-    console.log(`[Jira Manager] ✅ 15m de andamento registrados no Jira para ${key} (Commit ${gitMeta.shortSha}).`);
-    return { key, status: 'logged', timeSpentSeconds };
-  } else {
-    console.warn(`[Jira Manager] ⚠️ Falha ao registrar tempo para ${key}: HTTP ${res.status}`);
-    return { key, status: 'failed', code: res.status };
-  }
-}
-
-async function runTimeTracking() {
-  console.log('--- Início da Execução do Jira Time Tracking Automático ---');
-  const credentials = getAtlassianCredentials();
-  if (!credentials.isConfigured) {
-    console.log('[Jira Manager] ℹ Credenciais Atlassian não configuradas. Pulando registro de tempo.');
-    return;
-  }
-
-  const gitMeta = getGitMetadata();
-  const keys = [
-    ...extractIssueKeys(gitMeta.branch),
-    ...extractIssueKeys(gitMeta.commitMessage)
-  ];
-
-  const uniqueKeys = [...new Set(keys)];
-  if (uniqueKeys.length === 0) {
-    console.log('[Jira Manager] ℹ Nenhuma chave Jira identificada na branch ou mensagem de commit.');
-    return;
-  }
-
-  console.log(`[Jira Manager] Chaves detectadas: ${uniqueKeys.join(', ')}`);
-  for (const key of uniqueKeys) {
-    try {
-      await trackIssueTime(credentials, key, gitMeta);
-    } catch (err) {
-      console.error(`[Jira Manager] ❌ Erro ao processar tempo para ${key}:`, err.message);
-    }
-  }
-}
-
-if (require.main === module) {
-  const args = process.argv.slice(2);
-  if (args.includes('--track')) {
-    runTimeTracking().catch(console.error);
-  } else {
-    console.log('Jira Manager operacional. Use --track para executar apontamento de horas.');
-  }
-}
-
-module.exports = {
-  // Kanban
-  CANONICAL_KANBANS,
-  CANONICAL_COLUMNS_LIST,
-  sanitizeIssueSummary,
-  checkWipLimit,
-  resolveCanonicalColumn,
-  standardizeBoardColumns,
-  buildCanonicalJql,
-  validateSprintHealth,
-  evaluateFullDevCandidate,
-  processFullDevPipeline,
-  // Time Tracking
-  extractIssueKeys,
-  getExistingWorklogs,
-  logWorkTime,
-  ensureInProgress,
-  trackIssueTime,
-  runTimeTracking
-};