@jaimevalasek/aioson 1.7.0 → 1.8.0

package/src/commands/briefing.js

@@ -0,0 +1,344 @@
+'use strict';
+
+/**
+ * aioson briefing:approve  — Mark a draft briefing as approved
+ * aioson briefing:unapprove — Return approved briefing(s) to draft
+ *
+ * Usage:
+ *   aioson briefing:approve .
+ *   aioson briefing:approve . --slug=cypher-agent
+ *   aioson briefing:unapprove .
+ *   aioson briefing:unapprove . --slug=cypher-agent
+ *
+ * Config file: .aioson/briefings/config.md
+ * Format: YAML frontmatter (briefings: array) + Markdown table
+ */
+
+const fs = require('node:fs/promises');
+const path = require('node:path');
+const readline = require('node:readline');
+
+// ─── Config path ──────────────────────────────────────────────────────────────
+
+function configPath(projectDir) {
+  return path.join(projectDir, '.aioson', 'briefings', 'config.md');
+}
+
+// ─── YAML frontmatter parser (briefings-specific) ────────────────────────────
+
+/**
+ * Parse .aioson/briefings/config.md frontmatter.
+ * Returns { updated_at, briefings: [...] }
+ *
+ * Expected format:
+ *   ---
+ *   updated_at: 2026-04-10
+ *   briefings:
+ *     - slug: foo
+ *       status: draft
+ *       source_plans: [plans/x.md]
+ *       created_at: "2026-04-10"
+ *       approved_at: null
+ *       prd_generated: null
+ *   ---
+ */
+function parseConfigFrontmatter(content) {
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!match) return null;
+
+  const raw = match[1];
+  const lines = raw.split(/\r?\n/);
+
+  const result = { updated_at: null, briefings: [] };
+  let inBriefings = false;
+  let currentItem = null;
+
+  for (const line of lines) {
+    if (/^updated_at:\s*(.*)$/.test(line)) {
+      result.updated_at = line.replace(/^updated_at:\s*/, '').trim().replace(/^["']|["']$/g, '');
+      continue;
+    }
+
+    if (/^briefings:/.test(line)) {
+      inBriefings = true;
+      continue;
+    }
+
+    if (!inBriefings) continue;
+
+    // New item in array
+    if (/^\s{2}-\s+slug:\s*(.+)/.test(line)) {
+      if (currentItem) result.briefings.push(currentItem);
+      const slug = line.replace(/^\s{2}-\s+slug:\s*/, '').trim().replace(/^["']|["']$/g, '');
+      currentItem = { slug, status: 'draft', source_plans: [], created_at: null, approved_at: null, prd_generated: null };
+      continue;
+    }
+
+    if (currentItem) {
+      const fieldMatch = line.match(/^\s{4}(\w+):\s*(.*)/);
+      if (!fieldMatch) continue;
+      const [, key, rawVal] = fieldMatch;
+      const val = rawVal.trim().replace(/^["']|["']$/g, '');
+
+      if (key === 'source_plans') {
+        // Parse inline array: [plans/x.md, plans/y.md]
+        const arrMatch = val.match(/^\[(.+)\]$/);
+        currentItem.source_plans = arrMatch
+          ? arrMatch[1].split(',').map((s) => s.trim().replace(/^["']|["']$/g, ''))
+          : val === '' ? [] : [val];
+      } else if (val === 'null' || val === '') {
+        currentItem[key] = null;
+      } else {
+        currentItem[key] = val;
+      }
+    }
+  }
+
+  if (currentItem) result.briefings.push(currentItem);
+  return result;
+}
+
+// ─── Config serializer ────────────────────────────────────────────────────────
+
+function serializeSourcePlans(plans) {
+  if (!plans || plans.length === 0) return '[]';
+  const items = plans.map((p) => `"${p}"`).join(', ');
+  return `[${items}]`;
+}
+
+function serializeConfigFrontmatter(data) {
+  const lines = ['---', `updated_at: ${data.updated_at || new Date().toISOString().slice(0, 10)}`, 'briefings:'];
+
+  for (const b of data.briefings) {
+    lines.push(`  - slug: ${b.slug}`);
+    lines.push(`    status: ${b.status}`);
+    lines.push(`    source_plans: ${serializeSourcePlans(b.source_plans)}`);
+    lines.push(`    created_at: "${b.created_at || ''}"`);
+    lines.push(`    approved_at: ${b.approved_at ? `"${b.approved_at}"` : 'null'}`);
+    lines.push(`    prd_generated: ${b.prd_generated ? `"${b.prd_generated}"` : 'null'}`);
+  }
+
+  lines.push('---');
+  return lines.join('\n');
+}
+
+// ─── Markdown table builder ───────────────────────────────────────────────────
+
+function buildMarkdownTable(briefings) {
+  const header = '| slug | status | source_plans | created | approved | prd |';
+  const sep = '|------|--------|-------------|---------|----------|-----|';
+  const rows = briefings.map((b) => {
+    const sources = (b.source_plans || []).join(', ') || '—';
+    return `| ${b.slug} | ${b.status} | ${sources} | ${b.created_at || '—'} | ${b.approved_at || '—'} | ${b.prd_generated || '—'} |`;
+  });
+  return [header, sep, ...rows].join('\n');
+}
+
+// ─── Config writer ────────────────────────────────────────────────────────────
+
+async function writeConfig(configFile, data) {
+  const frontmatter = serializeConfigFrontmatter(data);
+  const table = buildMarkdownTable(data.briefings);
+  const body = `\n# Briefings Registry\n\n${table}\n`;
+  await fs.writeFile(configFile, `${frontmatter}\n${body}`, 'utf8');
+}
+
+// ─── Interactive prompt helpers ───────────────────────────────────────────────
+
+/**
+ * Show a numbered list and ask user to pick one by number.
+ * Returns the 0-based index of the selected item, or -1 on cancel.
+ */
+function promptSelect(items, promptText) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+    process.stdout.write('\n');
+    items.forEach((item, i) => {
+      process.stdout.write(`  ${i + 1}. ${item}\n`);
+    });
+    process.stdout.write('\n');
+
+    rl.question(`${promptText} `, (answer) => {
+      rl.close();
+      const num = parseInt(answer.trim(), 10);
+      if (!answer.trim() || isNaN(num) || num < 1 || num > items.length) {
+        resolve(-1);
+      } else {
+        resolve(num - 1);
+      }
+    });
+  });
+}
+
+/**
+ * Show a numbered list (all selected by default) and ask user to type
+ * comma-separated numbers to DESELECT. Returns indices to deselect.
+ */
+function promptCheckboxDeselect(items, promptText) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+    process.stdout.write('\n');
+    items.forEach((item, i) => {
+      process.stdout.write(`  [${i + 1}] ${item}\n`);
+    });
+    process.stdout.write('\n');
+
+    rl.question(`${promptText} `, (answer) => {
+      rl.close();
+      if (!answer.trim()) {
+        resolve([]);
+        return;
+      }
+      const indices = answer
+        .split(',')
+        .map((s) => parseInt(s.trim(), 10) - 1)
+        .filter((n) => !isNaN(n) && n >= 0 && n < items.length);
+      resolve(indices);
+    });
+  });
+}
+
+// ─── briefing:approve ─────────────────────────────────────────────────────────
+
+async function runBriefingApprove({ args, options = {}, logger }) {
+  const projectDir = path.resolve(process.cwd(), args[0] || '.');
+  const slugOpt = String(options.slug || '').trim() || null;
+  const configFile = configPath(projectDir);
+
+  // ── Read config ────────────────────────────────────────────────────────────
+  let raw;
+  try {
+    raw = await fs.readFile(configFile, 'utf8');
+  } catch {
+    logger.error('Nenhum briefing encontrado. Ative @cypher para criar o primeiro briefing.');
+    return { ok: false, error: 'no_config' };
+  }
+
+  const data = parseConfigFrontmatter(raw);
+  if (!data) {
+    logger.error('config.md com frontmatter inválido. Verifique o arquivo manualmente.');
+    return { ok: false, error: 'invalid_frontmatter' };
+  }
+
+  const drafts = data.briefings.filter((b) => b.status === 'draft');
+
+  if (drafts.length === 0) {
+    logger.log('Nenhum briefing aguardando aprovação.');
+    return { ok: true, approved: null };
+  }
+
+  // ── Select briefing ────────────────────────────────────────────────────────
+  let target;
+
+  if (slugOpt) {
+    target = drafts.find((b) => b.slug === slugOpt);
+    if (!target) {
+      logger.error(`Briefing "${slugOpt}" não encontrado ou não está em status draft.`);
+      logger.log(`Briefings draft disponíveis: ${drafts.map((b) => b.slug).join(', ')}`);
+      return { ok: false, error: 'slug_not_found' };
+    }
+  } else {
+    const labels = drafts.map((b) => `${b.slug} — criado em ${b.created_at || '?'}`);
+    logger.log('Briefings aguardando aprovação:');
+    const idx = await promptSelect(labels, 'Digite o número do briefing para aprovar (Enter = cancelar):');
+
+    if (idx === -1) {
+      logger.log('Operação cancelada.');
+      return { ok: true, approved: null };
+    }
+    target = drafts[idx];
+  }
+
+  // ── Approve ────────────────────────────────────────────────────────────────
+  const today = new Date().toISOString().slice(0, 10);
+
+  const briefingEntry = data.briefings.find((b) => b.slug === target.slug);
+  briefingEntry.status = 'approved';
+  briefingEntry.approved_at = today;
+  data.updated_at = today;
+
+  await writeConfig(configFile, data);
+
+  logger.log(`✓ Briefing "${target.slug}" aprovado.`);
+  logger.log('  Ative @product para gerar o PRD — ele detectará o briefing aprovado automaticamente.');
+
+  return { ok: true, approved: target.slug };
+}
+
+// ─── briefing:unapprove ───────────────────────────────────────────────────────
+
+async function runBriefingUnapprove({ args, options = {}, logger }) {
+  const projectDir = path.resolve(process.cwd(), args[0] || '.');
+  const slugOpt = String(options.slug || '').trim() || null;
+  const configFile = configPath(projectDir);
+
+  // ── Read config ────────────────────────────────────────────────────────────
+  let raw;
+  try {
+    raw = await fs.readFile(configFile, 'utf8');
+  } catch {
+    logger.error('Nenhum briefing encontrado. Ative @cypher para criar o primeiro briefing.');
+    return { ok: false, error: 'no_config' };
+  }
+
+  const data = parseConfigFrontmatter(raw);
+  if (!data) {
+    logger.error('config.md com frontmatter inválido. Verifique o arquivo manualmente.');
+    return { ok: false, error: 'invalid_frontmatter' };
+  }
+
+  // Only approved and non-implemented briefings can be unapproved
+  const approveds = data.briefings.filter((b) => b.status === 'approved');
+
+  if (approveds.length === 0) {
+    logger.log('Nenhum briefing aprovado disponível para retornar a draft.');
+    return { ok: true, unapproved: [] };
+  }
+
+  // ── Select briefings to unapprove ──────────────────────────────────────────
+  let targets;
+
+  if (slugOpt) {
+    const found = approveds.find((b) => b.slug === slugOpt);
+    if (!found) {
+      logger.error(`Briefing "${slugOpt}" não encontrado ou não está em status approved.`);
+      logger.log(`Briefings approved disponíveis: ${approveds.map((b) => b.slug).join(', ')}`);
+      return { ok: false, error: 'slug_not_found' };
+    }
+    targets = [found];
+  } else {
+    const labels = approveds.map((b) => `${b.slug} — aprovado em ${b.approved_at || '?'}`);
+    logger.log('Briefings aprovados (todos marcados). Digite os números para DESMARCAR:');
+    const toDeselect = await promptCheckboxDeselect(
+      labels,
+      'Números para retornar a draft (vírgula-separados, Enter = sem mudanças):'
+    );
+
+    if (toDeselect.length === 0) {
+      logger.log('Nenhuma mudança aplicada.');
+      return { ok: true, unapproved: [] };
+    }
+    targets = toDeselect.map((i) => approveds[i]);
+  }
+
+  // ── Unapprove ──────────────────────────────────────────────────────────────
+  const today = new Date().toISOString().slice(0, 10);
+
+  for (const target of targets) {
+    const entry = data.briefings.find((b) => b.slug === target.slug);
+    entry.status = 'draft';
+    entry.approved_at = null;
+  }
+  data.updated_at = today;
+
+  await writeConfig(configFile, data);
+
+  const names = targets.map((b) => b.slug);
+  logger.log(`✓ ${names.length === 1 ? `Briefing "${names[0]}" retornado` : `Briefings retornados`} para draft: ${names.join(', ')}`);
+
+  return { ok: true, unapproved: names };
+}
+
+module.exports = { runBriefingApprove, runBriefingUnapprove };