nexus-core-v3 3.0.0

package/checklists/story-dod-checklist.md

@@ -0,0 +1,52 @@
+---
+id: story-dod-checklist
+kind: checklist
+agent: dev
+gate: Definition of Done
+decision: "qualquer item crítico (1-7) FALHO → NÃO PRONTO; todos OK → Ready for Review"
+---
+
+# Story DoD Checklist (Definition of Done)
+
+> O @dev (Dex) roda isto antes de setar a story como `Ready for Review`. Não é sobre "tentei" — é sobre
+> "entreguei e provei". Veredito binário: **READY FOR REVIEW** (todos os críticos passam) ou **NÃO PRONTO**
+> (lista do que falta). Story que vai para o @qa sem passar aqui volta como retrabalho.
+
+## Críticos — qualquer falha aqui = NÃO PRONTO
+
+- [ ] 1. **Todos os ACs atendidos** — cada critério de aceite da story tem implementação correspondente;
+      nenhum AC ficou sem cobertura ou foi parcialmente entregue.
+- [ ] 2. **Todas as tasks/subtasks `[x]`** — cada checkbox marcado tem código + teste por trás; nenhum
+      `[x]` marcado por adiantamento ("testo depois").
+- [ ] 3. **Testes escritos e verdes** — caminho feliz + casos de erro/borda cobertos; a suíte inteira
+      (`*run-tests`) roda e passa, sem teste pulado/skip sem justificativa.
+- [ ] 4. **Lint e validações passando** — lint/typecheck verdes; zero erro novo introduzido por esta story.
+- [ ] 5. **Regressão completa rodada** — TODOS os testes do projeto executados (não só os da story) e
+      nenhuma regressão; nada quebrou no que já funcionava.
+- [ ] 6. **File List completa e correta** — todo arquivo criado, modificado ou deletado está listado;
+      nada de tocar arquivo fora da File List sem registrá-lo.
+- [ ] 7. **Sem invenção / sem dependência não aprovada** (Constituição Art. IV) — nada implementado fora
+      do escopo da story; nenhuma dependência nova entrou sem aprovação explícita.
+
+## Não-críticos — falha vira nota em Completion Notes, não bloqueio
+
+- [ ] 8. **CodeRabbit rodado** — review automático executado; CRITICAL corrigido no lugar (máx. 2
+      iterações). Achados de menor severidade ficam documentados, não pendentes silenciosos.
+- [ ] 9. **Menor caminho respeitado** — sem super-construção; reusou padrões/utilitários já existentes
+      antes de criar estrutura nova.
+- [ ] 10. **Dev Agent Record preenchido** — Debug Log, Completion Notes e Change Log refletem o que foi
+      feito, decisões tomadas e qualquer débito conhecido deixado para o @qa.
+- [ ] 11. **Fronteiras respeitadas** — só editei minhas seções da story (Dev Agent Record, checkboxes,
+      File List, Status); AC/escopo/Dev Notes/Testing intocados. Schema → @data-engineer; UI →
+      @ux-design-expert; push/PR → @devops.
+
+## Decisão
+
+**Veredito:** READY FOR REVIEW / NÃO PRONTO
+**Críticos (1-7):** {n}/7 OK
+**Não-críticos (8-11):** {n}/4 OK
+**Pendências (se NÃO PRONTO ou notas para o @qa):**
+- {item — o que falta ou que débito conhecido segue para review}
+
+> Se READY FOR REVIEW: seto `Status: Ready for Review` e HALTO. Eu **não** dou push — quem sobe é o @devops.
+> Se NÃO PRONTO: volto ao loop de implementação; não passo problema crítico conhecido adiante.

package/checklists/story-draft-checklist.md

@@ -0,0 +1,36 @@
+---
+id: story-draft-checklist
+kind: checklist
+agent: po
+gate: Definition of Ready
+decision: ">=7/10 → GO; <7 → NO-GO com correções obrigatórias"
+---
+
+# Story Draft Checklist (Definition of Ready)
+
+> O @po roda isto antes de a story ir para o @dev. Veredito: **GO** (≥7 dos 10) ou **NO-GO** (lista de
+> correções). Story que entra em desenvolvimento sem passar aqui é retrabalho garantido.
+
+## Critérios (10 pontos)
+
+- [ ] 1. **Título e escopo claros** — dá pra dizer o que a story entrega em uma frase.
+- [ ] 2. **Story bem formada** — "Como {persona}, quero {ação}, para {benefício}" preenchida e coerente.
+- [ ] 3. **ACs testáveis** — cada critério de aceite é verificável com sim/não; nada de "funciona bem".
+- [ ] 4. **ACs rastreáveis** — cada AC liga a um FR/NFR/objetivo; nenhum AC inventado (No Invention).
+- [ ] 5. **Tasks/Subtasks presentes** — há decomposição técnica e cada uma aponta para o(s) AC(s).
+- [ ] 6. **Dev Notes autossuficientes** — o @dev consegue implementar sem abrir outros docs; afirmações
+      técnicas citam a fonte (`docs/architecture/...`, `docs/specs/...`).
+- [ ] 7. **Seção Testing definida** — estratégia + casos (incl. erro/edge) + como rodar.
+- [ ] 8. **Dependências mapeadas** — stories/serviços/dados de que esta depende estão identificados.
+- [ ] 9. **Dono certo** — o trabalho cabe na lane de um agente; o que sai (schema, UI, subida) está
+      delegado ao dono (@data-engineer / @ux-design-expert / @devops).
+- [ ] 10. **Tamanho sensato** — a story cabe num ciclo; se é grande demais, o @sm fatia antes.
+
+## Decisão
+
+**Veredito:** GO (≥7) / NO-GO (<7)
+**Pontuação:** {x}/10
+**Correções obrigatórias (se NO-GO):**
+- {item — o que falta para virar GO}
+
+> NO-GO não é reprovação: é a lista exata do que o @sm ajusta para a story ficar pronta.

package/dist/bin/dashboard.html

@@ -0,0 +1,279 @@
+<!doctype html>
+<html lang="pt-BR">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>Nexus</title>
+  <link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'%3E%3Crect width='32' height='32' rx='7' fill='%230f766e'/%3E%3Ctext x='16' y='23' font-size='20' font-family='sans-serif' font-weight='700' fill='white' text-anchor='middle'%3En%3C/text%3E%3C/svg%3E" />
+  <style>
+    /* ── design tokens (claro/escuro por prefers-color-scheme) ───────────────── */
+    :root {
+      color-scheme: light dark;
+      --bg: #faf9f7;
+      --surface: #ffffff;
+      --surface-2: #f4f2ef;
+      --text: #1c1917;
+      --muted: #78716c;
+      --border: #e7e4df;
+      --accent: #0f766e;
+      --accent-ink: #ffffff;
+      --ok: #15803d;
+      --warn: #b45309;
+      --bad: #b91c1c;
+      --mono: ui-monospace, "SF Mono", "SFMono-Regular", Menlo, Consolas, monospace;
+      --sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+      --radius: 10px;
+      --shadow: 0 1px 2px rgba(28,25,23,.06), 0 1px 3px rgba(28,25,23,.04);
+    }
+    @media (prefers-color-scheme: dark) {
+      :root {
+        --bg: #0c0a09; --surface: #1c1917; --surface-2: #292524;
+        --text: #f5f5f4; --muted: #a8a29e; --border: #292524;
+        --accent: #2dd4bf; --accent-ink: #042f2e;
+        --ok: #4ade80; --warn: #fbbf24; --bad: #f87171;
+        --shadow: none;
+      }
+    }
+    * { box-sizing: border-box; }
+    html, body { height: 100%; }
+    body {
+      margin: 0; font-family: var(--sans); color: var(--text); background: var(--bg);
+      font-size: 15px; line-height: 1.55; -webkit-font-smoothing: antialiased;
+      display: grid; grid-template-columns: 232px 1fr; min-height: 100vh;
+    }
+    /* ── barra lateral ────────────────────────────────────────────────────────── */
+    aside {
+      border-right: 1px solid var(--border); background: var(--surface);
+      display: flex; flex-direction: column; padding: 20px 14px; gap: 4px; position: sticky; top: 0; height: 100vh;
+    }
+    .brand { display: flex; align-items: baseline; gap: 3px; padding: 6px 10px 18px; }
+    .brand b { font-size: 22px; font-weight: 700; letter-spacing: -.02em; }
+    .brand .dot { width: 7px; height: 7px; border-radius: 50%; background: var(--accent); align-self: center; margin-left: 2px; }
+    .brand span { font-size: 11px; color: var(--muted); margin-left: auto; text-transform: uppercase; letter-spacing: .08em; }
+    nav { display: flex; flex-direction: column; gap: 2px; }
+    nav button {
+      appearance: none; border: 0; background: transparent; color: var(--text); font: inherit;
+      text-align: left; padding: 8px 10px; border-radius: 8px; cursor: pointer; display: flex; gap: 10px; align-items: center;
+    }
+    nav button:hover { background: var(--surface-2); }
+    nav button[aria-current="true"] { background: var(--accent); color: var(--accent-ink); font-weight: 600; }
+    nav .ico { width: 18px; text-align: center; opacity: .9; font-size: 15px; }
+    aside footer { margin-top: auto; padding: 10px; font-size: 12px; color: var(--muted); }
+    /* ── conteúdo ─────────────────────────────────────────────────────────────── */
+    main { padding: 34px clamp(20px, 4vw, 56px); max-width: 1000px; width: 100%; }
+    header.page { margin-bottom: 22px; }
+    header.page h1 { margin: 0 0 4px; font-size: 24px; letter-spacing: -.02em; }
+    header.page p { margin: 0; color: var(--muted); }
+    .card { background: var(--surface); border: 1px solid var(--border); border-radius: var(--radius); box-shadow: var(--shadow); padding: 20px; }
+    .card + .card { margin-top: 16px; }
+    pre.out {
+      font-family: var(--mono); font-size: 12.5px; line-height: 1.5; white-space: pre-wrap; word-break: break-word;
+      background: var(--surface-2); border: 1px solid var(--border); border-radius: 8px; padding: 14px 16px; margin: 0; overflow-x: auto;
+    }
+    button.act, .chip, select, input, textarea {
+      font: inherit; border-radius: 8px; border: 1px solid var(--border); background: var(--surface); color: var(--text);
+    }
+    button.act {
+      background: var(--accent); color: var(--accent-ink); border-color: transparent; padding: 9px 16px; font-weight: 600; cursor: pointer;
+    }
+    button.act:disabled { opacity: .55; cursor: not-allowed; }
+    button.ghost { background: var(--surface); color: var(--text); border: 1px solid var(--border); padding: 8px 14px; border-radius: 8px; cursor: pointer; font: inherit; }
+    input, select, textarea { padding: 9px 12px; width: 100%; }
+    textarea { resize: vertical; min-height: 84px; font-family: var(--sans); }
+    label { display: block; font-size: 13px; color: var(--muted); margin: 0 0 5px; }
+    .row { display: flex; gap: 10px; align-items: center; flex-wrap: wrap; }
+    .field + .field { margin-top: 14px; }
+    .chips { display: flex; gap: 8px; flex-wrap: wrap; margin-top: 12px; }
+    .chip { padding: 7px 12px; cursor: pointer; font-size: 13px; color: var(--muted); }
+    .chip:hover { border-color: var(--accent); color: var(--text); }
+    .muted { color: var(--muted); }
+    .empty { color: var(--muted); text-align: center; padding: 32px 12px; }
+    .plist { list-style: none; margin: 0; padding: 0; }
+    .plist li { display: flex; justify-content: space-between; align-items: center; padding: 12px 4px; border-bottom: 1px solid var(--border); }
+    .plist li:last-child { border-bottom: 0; }
+    .plist .p-name { font-weight: 600; }
+    .plist .p-path { font-family: var(--mono); font-size: 12px; color: var(--muted); }
+    .health li { display: flex; gap: 10px; align-items: baseline; padding: 8px 4px; border-bottom: 1px solid var(--border); list-style: none; }
+    .health { margin: 0; padding: 0; }
+    .light { width: 9px; height: 9px; border-radius: 50%; flex: 0 0 auto; margin-top: 6px; }
+    .light.ok { background: var(--ok); } .light.warn { background: var(--warn); } .light.bad { background: var(--bad); }
+    .ev { font-family: var(--mono); font-size: 12.5px; padding: 3px 0; border-bottom: 1px dashed var(--border); }
+    .ev .tag { display: inline-block; min-width: 74px; color: var(--accent); font-weight: 600; }
+    .spin { color: var(--muted); font-size: 13px; }
+    .banner { background: color-mix(in srgb, var(--bad) 12%, var(--surface)); border: 1px solid var(--bad); color: var(--bad); padding: 12px 14px; border-radius: 8px; margin-bottom: 16px; font-size: 14px; }
+    @media (max-width: 720px) { body { grid-template-columns: 1fr; } aside { position: static; height: auto; flex-direction: row; flex-wrap: wrap; } aside footer { display: none; } }
+  </style>
+</head>
+<body>
+  <aside>
+    <div class="brand"><b>nexus</b><i class="dot"></i><span>local</span></div>
+    <nav id="nav"></nav>
+    <footer>Tudo roda na sua máquina, com a sua assinatura.<br />Nada sai daqui.</footer>
+  </aside>
+  <main>
+    <div id="authwarn" class="banner" hidden>Sessão sem token válido — reabra pelo link que o <code>nexus serve</code> imprimiu no terminal.</div>
+    <header class="page"><h1 id="ptitle"></h1><p id="psub"></p></header>
+    <section id="panel"></section>
+  </main>
+
+  <script>
+    'use strict';
+    const token = new URLSearchParams(location.search).get('t') || '';
+    const $ = (id) => document.getElementById(id);
+    const el = (tag, attrs, ...kids) => {
+      const n = document.createElement(tag);
+      for (const k in (attrs || {})) {
+        if (k === 'class') n.className = attrs[k];
+        else if (k === 'html') n.innerHTML = attrs[k];
+        else if (k.startsWith('on')) n.addEventListener(k.slice(2), attrs[k]);
+        else n.setAttribute(k, attrs[k]);
+      }
+      for (const kid of kids) n.append(kid && kid.nodeType ? kid : document.createTextNode(kid == null ? '' : String(kid)));
+      return n;
+    };
+    const ESC = String.fromCharCode(27);
+    const ansi = new RegExp(ESC + '[[]' + '[0-9;?]*[a-zA-Z]', 'g');
+    const clean = (s) => (s || '').replace(ansi, '');
+
+    async function api(path, opts) {
+      opts = opts || {};
+      const headers = Object.assign({ 'Authorization': 'Bearer ' + token }, opts.headers || {});
+      const res = await fetch(path, Object.assign({}, opts, { headers }));
+      if (res.status === 401) { $('authwarn').hidden = false; throw new Error('401'); }
+      return res;
+    }
+    const getJson = async (path) => (await api(path)).json();
+
+    // ── painéis ────────────────────────────────────────────────────────────────
+    const panel = $('panel');
+    const setBusy = (msg) => { panel.replaceChildren(el('p', { class: 'spin' }, msg || 'Carregando…')); };
+
+    async function textPanel(path, empty) {
+      setBusy();
+      try {
+        const d = await getJson(path);
+        const t = clean(d.text || '').trim();
+        panel.replaceChildren(t ? el('pre', { class: 'out' }, t) : el('div', { class: 'empty' }, empty || 'Nada por aqui ainda.'));
+      } catch (e) { if (e.message !== '401') panel.replaceChildren(el('div', { class: 'empty' }, 'Não consegui carregar. Confira a Saúde do sistema.')); }
+    }
+
+    async function saude() {
+      setBusy('Checando o ambiente…');
+      try {
+        const d = await getJson('/api/doctor');
+        const lines = clean(d.text || '').split(String.fromCharCode(10)).map((l) => l.trim()).filter(Boolean);
+        const ul = el('ul', { class: 'health' });
+        for (const line of lines) {
+          let cls = 'ok';
+          if (/\[(falha|erro|fail)/i.test(line)) cls = 'bad';
+          else if (/\[(aviso|warn)/i.test(line)) cls = 'warn';
+          const label = line.replace(/^\[[^\]]*\]\s*/, '');
+          ul.append(el('li', {}, el('i', { class: 'light ' + cls }), el('span', {}, label)));
+        }
+        panel.replaceChildren(el('div', { class: 'card' }, ul), el('div', { class: 'row', style: 'margin-top:14px' }, el('button', { class: 'ghost', onclick: saude }, 'Verificar de novo')));
+      } catch (e) { if (e.message !== '401') panel.replaceChildren(el('div', { class: 'empty' }, 'Não consegui rodar o diagnóstico.')); }
+    }
+
+    async function projetos() {
+      setBusy();
+      try {
+        const d = await getJson('/api/projects');
+        const list = d.projects || [];
+        const card = el('div', { class: 'card' });
+        if (!list.length) card.append(el('div', { class: 'empty' }, 'Nenhum projeto ainda — crie o primeiro abaixo.'));
+        else {
+          const ul = el('ul', { class: 'plist' });
+          for (const p of list) ul.append(el('li', {}, el('div', {}, el('div', { class: 'p-name' }, p.name || p.path), el('div', { class: 'p-path' }, p.path)), el('span', { class: 'muted' }, p.lastRunAt ? ('última: ' + p.lastRunAt) : 'sem missões')));
+          card.append(ul);
+        }
+        const nameI = el('input', { placeholder: 'nome do projeto', 'aria-label': 'nome do projeto' });
+        const out = el('div', { class: 'muted', style: 'margin-top:10px' });
+        const create = el('button', {
+          class: 'act', onclick: async () => {
+            if (!nameI.value.trim()) return;
+            create.disabled = true; out.textContent = 'Criando…';
+            try {
+              const r = await api('/api/projects', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ name: nameI.value.trim() }) });
+              const b = await r.json();
+              if (r.ok) { out.textContent = ''; projetos(); } else { out.textContent = 'Não deu: ' + (b.error || r.status); }
+            } catch (e) { out.textContent = 'Falhou: ' + e.message; } finally { create.disabled = false; }
+          }
+        }, 'Criar projeto');
+        panel.replaceChildren(card, el('div', { class: 'card' }, el('label', {}, 'Novo projeto'), el('div', { class: 'row' }, nameI, create), out));
+      } catch (e) { if (e.message !== '401') panel.replaceChildren(el('div', { class: 'empty' }, 'Não consegui listar os projetos.')); }
+    }
+
+    function parseFrame(frame) {
+      const ev = { event: 'message', data: {} };
+      for (const line of frame.split(String.fromCharCode(10))) {
+        if (line.startsWith('event:')) ev.event = line.slice(6).trim();
+        else if (line.startsWith('data:')) { try { ev.data = JSON.parse(line.slice(5).trim()); } catch (_) { ev.data = { raw: line.slice(5) }; } }
+      }
+      return ev;
+    }
+
+    async function missao() {
+      let projects = [];
+      try { projects = (await getJson('/api/projects')).projects || []; } catch (e) { if (e.message === '401') return; }
+      const sel = el('select', { 'aria-label': 'projeto' });
+      if (!projects.length) sel.append(el('option', { value: '' }, '— nenhum projeto (crie um em Projetos) —'));
+      for (const p of projects) sel.append(el('option', { value: p.path }, (p.name || p.path)));
+      const obj = el('textarea', { placeholder: 'Descreva o que você quer. Ex.: "crie uma landing page para uma cafeteria, com seção de menu e contato".', 'aria-label': 'objetivo da missão' });
+      const log = el('div', { class: 'card', style: 'margin-top:16px', hidden: 'hidden' });
+      const run = el('button', {
+        class: 'act', onclick: async () => {
+          const projectPath = sel.value; const objective = obj.value.trim();
+          if (!projectPath) { alert('Escolha (ou crie) um projeto primeiro.'); return; }
+          if (!objective) return;
+          run.disabled = true; log.hidden = false; log.replaceChildren(el('p', { class: 'spin' }, 'Iniciando a missão…'));
+          try {
+            const r = await api('/api/run', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ projectPath, objective }) });
+            const reader = r.body.getReader(); const dec = new TextDecoder(); let buf = ''; log.replaceChildren();
+            const sep = String.fromCharCode(10) + String.fromCharCode(10);
+            for (;;) {
+              const { done, value } = await reader.read(); if (done) break;
+              buf += dec.decode(value, { stream: true });
+              let i; while ((i = buf.indexOf(sep)) >= 0) { const frame = buf.slice(0, i); buf = buf.slice(i + 2); render(parseFrame(frame)); }
+            }
+          } catch (e) { if (e.message !== '401') log.append(el('div', { class: 'ev' }, 'erro: ' + e.message)); }
+          finally { run.disabled = false; }
+          function render(ev) {
+            if (ev.event === 'done') { log.append(el('div', { class: 'ev' }, el('span', { class: 'tag' }, 'concluído'), 'missão finalizada.')); return; }
+            if (ev.event === 'error') { log.append(el('div', { class: 'ev' }, el('span', { class: 'tag' }, 'erro'), ev.data.message || '')); return; }
+            const d = ev.data || {}; let txt = '';
+            if (ev.event === 'start') txt = 'objetivo: ' + (d.objective || '');
+            else if (ev.event === 'result') txt = 'código de saída ' + (d.exitCode != null ? d.exitCode : '?') + (d.output ? ' — ' + clean(String(d.output)).slice(0, 400) : '');
+            else txt = clean(JSON.stringify(d)).slice(0, 400);
+            log.append(el('div', { class: 'ev' }, el('span', { class: 'tag' }, ev.event), txt));
+          }
+        }
+      }, 'Executar missão');
+      const chips = el('div', { class: 'chips' });
+      for (const s of ['Criar um site', 'Criar um sistema', 'Automatizar uma tarefa', 'Analisar meu projeto']) chips.append(el('button', { class: 'chip', onclick: () => { obj.value = s + ': '; obj.focus(); } }, s));
+      panel.replaceChildren(el('div', { class: 'card' }, el('div', { class: 'field' }, el('label', {}, 'Projeto'), sel), el('div', { class: 'field' }, el('label', {}, 'O que você quer que o time faça?'), obj), chips, el('div', { class: 'row', style: 'margin-top:14px' }, run)), log);
+    }
+
+    // ── navegação ────────────────────────────────────────────────────────────────
+    const PANELS = [
+      { id: 'missao', ico: '◐', title: 'Missão', sub: 'Peça o que quiser — o time de agentes executa de verdade.', run: missao },
+      { id: 'projetos', ico: '▤', title: 'Projetos', sub: 'Os projetos que o Nexus conhece nesta máquina.', run: projetos },
+      { id: 'equipe', ico: '◇', title: 'Equipe', sub: 'Os agentes e o que cada um faz.', run: () => textPanel('/api/team', 'Nenhum agente no roster.') },
+      { id: 'matriz', ico: '⇄', title: 'Matriz', sub: 'Quem entrega para quem (delegações).', run: () => textPanel('/api/team/matrix') },
+      { id: 'runbooks', ico: '☰', title: 'Runbooks', sub: 'Roteiros prontos por cenário.', run: () => textPanel('/api/runbooks', 'Nenhum runbook instalado.') },
+      { id: 'manual', ico: '❏', title: 'Manual', sub: 'O guia do projeto.', run: () => textPanel('/api/manual', 'Sem manual neste projeto.') },
+      { id: 'metricas', ico: '▧', title: 'Métricas', sub: 'Custo e qualidade reais das missões.', run: () => textPanel('/api/metrics', 'Ainda sem dados — rode uma missão.') },
+      { id: 'saude', ico: '♥', title: 'Saúde', sub: 'O ambiente está pronto para trabalhar?', run: saude },
+    ];
+    const nav = $('nav');
+    function go(p) {
+      $('ptitle').textContent = p.title; $('psub').textContent = p.sub;
+      for (const b of nav.children) b.setAttribute('aria-current', b.dataset.id === p.id ? 'true' : 'false');
+      location.hash = p.id; p.run();
+    }
+    for (const p of PANELS) nav.append(el('button', { 'data-id': p.id, onclick: () => go(p) }, el('i', { class: 'ico' }, p.ico), p.title));
+    const start = PANELS.find((p) => p.id === location.hash.slice(1)) || PANELS[0];
+    if (!token) $('authwarn').hidden = false;
+    go(start);
+  </script>
+</body>
+</html>