@cccarv82/freya 2.5.3 → 2.5.5

package/cli/web-ui.js

@@ -1905,11 +1905,13 @@
     }
   }
 
+  state.slugRules = []; // Store the active project rules
+
   async function reloadSlugRules() {
     try {
       const r = await api('/api/project-slug-map/get', { dir: dirOrDefault() });
-      const el = $('slugRules');
-      if (el) el.value = JSON.stringify(r.map || { rules: [] }, null, 2);
+      state.slugRules = (r.map && Array.isArray(r.map.rules)) ? r.map.rules : [];
+      renderSlugRules();
       setPill('ok', 'rules loaded');
       setTimeout(() => setPill('ok', 'pronto'), 800);
     } catch (e) {
@@ -1918,18 +1920,82 @@
     }
   }
 
+  function renderSlugRules() {
+    const container = $('slugListContainer');
+    if (!container) return;
+
+    if (state.slugRules.length === 0) {
+      container.innerHTML = '<div class="help" style="margin-bottom: 10px;">Nenhuma regra cadastrada no momento.</div>';
+      return;
+    }
+
+    let html = '<div style="display:flex; flex-direction:column; gap:8px; margin-bottom: 16px;">';
+    state.slugRules.forEach((rule, index) => {
+      html += `
+        <div style="display:flex; align-items:center; justify-content:space-between; background: var(--bg2); padding: 10px 14px; border-radius: 6px; border: 1px solid var(--border);">
+          <div style="display:flex; gap: 12px; align-items:center; flex-wrap: wrap;">
+             <span style="font-size: 13px;"><span style="color:var(--text-muted); font-size:12px;">Se o texto contiver a palavra:</span> <b style="color: var(--primary);">${escapeHtml(rule.contains)}</b></span>
+             <span style="color:var(--text-muted)">→</span>
+             <span style="font-size: 13px;"><span style="color:var(--text-muted); font-size:12px;">Atribuir ao projeto:</span> <code class="md-inline">${escapeHtml(rule.slug)}</code></span>
+          </div>
+          <button class="btn small" type="button" onclick="window.removeSlugRule(${index})" title="Remover regra">Excluir</button>
+        </div>
+      `;
+    });
+    html += '</div>';
+    container.innerHTML = html;
+  }
+
+  function addSlugRule() {
+    const kw = $('newSlugKeyword');
+    const tg = $('newSlugTarget');
+    if (!kw || !tg) return;
+    const contains = kw.value.trim().toLowerCase();
+    const slug = tg.value.trim().toLowerCase();
+
+    if (!contains || !slug) {
+      setPill('err', 'Preencha ambos os campos');
+      setTimeout(() => setPill('ok', 'pronto'), 1500);
+      return;
+    }
+
+    // Check for duplicates
+    if (state.slugRules.some(r => r.contains === contains)) {
+      setPill('err', 'Palavra-chave já existe');
+      setTimeout(() => setPill('ok', 'pronto'), 1500);
+      return;
+    }
+
+    state.slugRules.push({ contains, slug });
+    kw.value = '';
+    tg.value = '';
+    renderSlugRules();
+
+    // Auto-save when adding
+    saveSlugRules();
+  }
+
+  function removeSlugRule(index) {
+    if (index >= 0 && index < state.slugRules.length) {
+      state.slugRules.splice(index, 1);
+      renderSlugRules();
+      // Auto-save when removing
+      saveSlugRules();
+    }
+  }
+
   async function saveSlugRules() {
     try {
-      const el = $('slugRules');
-      if (!el) return;
-      const raw = String(el.value || '').trim();
-      if (!raw) throw new Error('Rules JSON is empty');
-      let map;
-      try { map = JSON.parse(raw); } catch (e) { throw new Error('Invalid JSON: ' + (e.message || e)); }
-
       setPill('run', 'saving rules…');
+      const map = { rules: state.slugRules };
       const r = await api('/api/project-slug-map/save', { dir: dirOrDefault(), map });
-      if (el) el.value = JSON.stringify(r.map || map, null, 2);
+
+      // Update state with confirmed save
+      if (r.map && Array.isArray(r.map.rules)) {
+        state.slugRules = r.map.rules;
+        renderSlugRules();
+      }
+
       setPill('ok', 'rules saved');
       setTimeout(() => setPill('ok', 'pronto'), 800);
     } catch (e) {
@@ -2046,7 +2112,7 @@
         setPill('run', 'applying…');
         await applyPlan();
         const a = state.lastApplied || {};
-        setPill('ok', `applied (${a.tasks || 0}t, ${a.blockers || 0}b)`);
+        setPill('ok', `applied(${a.tasks || 0}t, ${a.blockers || 0}b)`);
         if (state.autoRunReports) {
           await runSuggestedReports();
         }
@@ -2082,7 +2148,7 @@
       let out = '## Ran suggested reports\n\n';
       for (const name of uniq) {
         const r = await api('/api/report', { dir: dirOrDefault(), script: name === 'status' ? 'status' : name });
-        out += `### ${name}\n` + (r.reportPath ? `- file: ${r.reportPath}\n` : '') + '\n';
+        out += `### ${name} \n` + (r.reportPath ? ` - file: ${r.reportPath} \n` : '') + '\n';
       }
 
       setOut(out);
@@ -2233,11 +2299,12 @@
   window.pickDir = pickDir;
   window.runReport = runReport;
   window.publish = publish;
-  window.saveSettings = saveSettings;
   window.refreshReports = refreshReports;
   window.refreshToday = refreshToday;
   window.reloadSlugRules = reloadSlugRules;
   window.saveSlugRules = saveSlugRules;
+  window.addSlugRule = addSlugRule;
+  window.removeSlugRule = removeSlugRule;
   window.exportObsidian = exportObsidian;
   window.rebuildIndex = rebuildIndex;
   window.renderReportsList = renderReportsList;

package/cli/web.js

@@ -1045,38 +1045,65 @@ function buildDocsHtml(safeDefault, appVersion) {
 
           <div class="centerBody">
             <div class="docs-content">
+              
               <div class="docs-card">
-                <h1 class="docs-h1">📚 Guia do Usuário FREYA</h1>
-                <p>Bem-vindo à FREYA (<strong class="docs-strong">Fast Reporting & Executive Yield Assistant</strong>), sua ferramenta local-first para gestão de status e relatórios executivos.</p>
-                
-                <h2 class="docs-h2">🚀 Começo Rápido (CLI)</h2>
-                <p>A FREYA nasceu no terminal. Use os comandos abaixo no seu diretório de trabalho:</p>
+                <h1 class="docs-h1">📚 Bem-vindo à FREYA</h1>
+                <p>A FREYA (<strong class="docs-strong">Fast Reporting & Executive Yield Assistant</strong>) é a sua assistente executiva local-first. Ela utiliza Inteligência Artificial e a sua base local de metadados para automatizar a extração de tarefas, gerar relatórios, manter o histórico de projetos alinhado e responder dúvidas contextuais sem depender de nuvens externas para a soberania de seus dados sensíveis.</p>
+              </div>
+
+              <div class="docs-card" id="docs-dashboard">
+                <h2 class="docs-h2" style="margin-top:0;">🏠 Dashboard & Inbox</h2>
+                <p>O coração do sistema. Aqui você insere seus apontamentos do dia a dia de forma natural e livre usando a <strong>Inbox Central</strong>.</p>
                 <ul class="docs-ul">
-                  <li><code class="docs-code">freya task "Sua tarefa"</code>: Cria uma tarefa pendente.</li>
-                  <li><code class="docs-code">freya blocker "Impedimento"</code>: Registra um bloqueio crítico.</li>
-                  <li><code class="docs-code">freya status "Update"</code>: Adiciona item ao histórico de um projeto.</li>
-                  <li><code class="docs-code">freya daily</code>: Abre seu log diário para edição.</li>
+                  <li><strong class="docs-strong">Prompt Inteligente:</strong> Ao colar um texto (ex: <i>"hoje finalizei a issue PTI123 mas fiquei bloqueado pelo time de banco"</i>) e enviar, a FREYA analisa e extrai tarefas pertinentes e registra impedimentos automaticamente.</li>
+                  <li><strong class="docs-strong">Oráculo (RAG):</strong> Um campo de chat conectado com o LLM de IA avançado. Pergunte <i>"O que eu informei ontem sobre o projeto X?"</i> e a FREYA consultará toda a varredura da base local para formular uma resposta consolidada mantendo formatação rica em HTML/Markdown.</li>
+                  <li><strong class="docs-strong">Tarefas (DO NOW / SCHEDULE):</strong> Acompanhe rapidamente as pendências cruciais para o seu dia. Resolução rápida com apenas um clique.</li>
                 </ul>
+                <div class="docs-pre">Dica de Input: "Reunião de kickoff do projeto Trato. Preciso cobrar a permissão de acesso amanhã."<br><br>Resultado Mágico: A FREYA cria uma pendência de "cobrança de acesso" atrelada ao projeto automaticamente!</div>
+              </div>
 
-                <h2 class="docs-h2">💻 Dashboard Web</h2>
+              <div class="docs-card" id="docs-reports">
+                <h2 class="docs-h2" style="margin-top:0;">📊 Relatórios (Reports)</h2>
+                <p>Geração instantânea de consolidados Markdown com base nos seus últimos logs, métricas e projetos.</p>
                 <ul class="docs-ul">
-                  <li><strong class="docs-strong">Inbox & Prompt</strong>: Cole textos e a FREYA extrai tarefas/bloqueios via análise inteligente.</li>
-                  <li><strong class="docs-strong">Oracle (RAG)</strong>: Use o chat para perguntar sobre seu histórico local.</li>
-                  <li><strong class="docs-strong">Hoje</strong>: Visualize suas pendências por categoria (DO_NOW, SCHEDULE, etc).</li>
+                  <li><strong class="docs-strong">Executive Status:</strong> Resumo executivo para visão holística em cima de tudo que aconteceu.</li>
+                  <li><strong class="docs-strong">SM Weekly:</strong> Um consolidado sob a ótica de Scrum Master para reportar fluxo e timeline.</li>
+                  <li><strong class="docs-strong">Blockers:</strong> Visão tática de impedimentos e gargalos estruturais divididos por severidade.</li>
+                  <li><strong class="docs-strong">Clipboard Fácil:</strong> Edite o Markdown gerado usando o painel integrado e copie rapidamente para uso no Outlook ou Confluence.</li>
                 </ul>
+              </div>
 
-                <h2 class="docs-h2">📊 Relatórios Automatizados</h2>
-                <p>Gere documentos Markdown prontos para uso:</p>
+              <div class="docs-card" id="docs-projects">
+                <h2 class="docs-h2" style="margin-top:0;">📂 Projetos (Projects) & Grafo (Graph)</h2>
+                <p>A central de clientes e iniciativas. Cada projeto (referenciado por seu <i>slug</i>, ex: <code>vivo/5g</code>) possui um histórico cronológico organizado.</p>
                 <ul class="docs-ul">
-                  <li><strong class="docs-strong">Executivo</strong>: Visão geral para gerência.</li>
-                  <li><strong class="docs-strong">SM Weekly</strong>: Indicadores de fluxo e aging.</li>
-                  <li><strong class="docs-strong">Blockers</strong>: Lista focada em impedimentos.</li>
+                  <li><strong class="docs-strong">Histórico Consolidado:</strong> Através da Inbox, as ações e status mapeados para um projeto alimentam essa visão com linha do tempo automaticamente.</li>
+                  <li><strong class="docs-strong">Grafo de Conhecimento (Graph):</strong> Todos os slugs, tarefas, clientes e datas formam nós interativos de uma rede. Permite descobrir dinâmicas ocultas e ver visualmente clientes demandando mais esforço.</li>
                 </ul>
-                <div class="docs-pre">Dica: Use os Webhooks para publicar direto no Discord ou Microsoft Teams.</div>
+              </div>
 
-                <h2 class="docs-h2">⚙️ Configurações</h2>
-                <p>Configure sua workspace, webhooks de notificação e regras de <strong class="docs-strong">Smart Mapping</strong> para associar updates a projetos automaticamente.</p>
+              <div class="docs-card" id="docs-settings">
+                <h2 class="docs-h2" style="margin-top:0;">⚙️ Configurações & Mapeamento Smart</h2>
+                <p>Customize sua experiência e treine a IA para catalogar seus clientes de forma rígida usando o <strong>Mapeamento Inteligente de Projetos</strong>.</p>
+                <ul class="docs-ul">
+                  <li>Embora a FREYA utilize o Copilot para criar novos <code>Slugs</code> on-the-fly de forma inteligente (ex: deduzir <code>vale/trato</code> da palavra Trato), você pode forçar regras pelo painel.</li>
+                  <li><strong class="docs-strong">Formato JSON de Regras:</strong><br>
+                  <code>{  "contains": "fideliza",  "slug": "vivo/fidelizacao" }</code><br>
+                  <i>Toda vez que um update citar a palavra-chave, a FREYA garantirá que ele caia na pasta padronizada.</i></li>
+                </ul>
               </div>
+
+              <div class="docs-card">
+                <h2 class="docs-h2" style="margin-top:0;">⌨️ CLI (Terminal)</h2>
+                <p>O poder nativo pelo console, caso você perca a conexão da Web UI ou prefira o velho bash.</p>
+                <ul class="docs-ul">
+                  <li><code class="docs-code">freya task "Revisar logs do servidor"</code>: Cria uma nova task rápida.</li>
+                  <li><code class="docs-code">freya blocker "Queda no link"</code>: Registra entrada na lista de problemas.</li>
+                  <li><code class="docs-code">freya status "Fase 2 aprovada!" --project acme/beta</code>: Injeta direto no banco de projetos.</li>
+                  <li><code class="docs-code">freya web</code>: Sobe o servidor back-end do Dashboard Mágico!</li>
+                </ul>
+              </div>
+
             </div>
           </div>
         </main>
@@ -3973,25 +4000,31 @@ function buildSettingsHtml(safeDefault, appVersion) {
 
             <div class="devGrid" style="grid-template-columns: 1fr;">
               <div class="panel">
-                <div class="panelHead"><b>Mapeamento Inteligente de Projetos (Slugs)</b></div>
+                <div class="panelHead" style="display:flex; justify-content:space-between; align-items:center;">
+                  <b>Mapeamento Inteligente de Projetos (Slugs)</b>
+                  <span class="chip" style="font-weight:normal; font-size:11px;">Rules</span>
+                </div>
                 <div class="panelBody">
                   <p style="margin-top: 0; color: #666; font-size: 13px;">
-                    A FREYA tenta adivinhar automaticamente a qual projeto uma tarefa pertence. 
-                    Se você quiser **garantir** que uma palavra sempre caia em um projeto específico, adicione uma regra abaixo.
+                    A FREYA tenta adivinhar automaticamente a qual projeto uma tarefa pertence com base no LLM. 
+                    Se você quiser <b>garantir</b> que uma palavra sempre caia em um projeto específico, adicione uma regra abaixo.
                   </p>
                   
-                  <div style="background: var(--surface); padding: 12px; border-radius: 6px; font-size: 12px; font-family: monospace; color: #888; margin-bottom: 16px;">
-                    <b>Exemplo de uso:</b><br>
-                    Se o cliente é a "Vale" e o projeto é "Trato", e você quer que qualquer frase com a palavra "trato" vá para "vale/trato":<br>
-                    <code>{ "contains": "trato", "slug": "vale/trato" }</code>
+                  <div class="slug-adder" style="display: flex; gap: 8px; margin-bottom: 24px; align-items: flex-end; background: var(--bg2); padding: 12px; border-radius: 8px; border: 1px solid var(--border);">
+                    <div style="flex: 1;">
+                      <label style="font-size: 12px; color: var(--text-muted); margin-bottom: 4px; display: block;">Palavra-chave (ex: fideliza)</label>
+                      <input type="text" id="newSlugKeyword" placeholder="Palavra a buscar..." style="width: 100%;" />
+                    </div>
+                    <div style="flex: 1;">
+                      <label style="font-size: 12px; color: var(--text-muted); margin-bottom: 4px; display: block;">Projeto Alvo (ex: vivo/fidelizacao)</label>
+                      <input type="text" id="newSlugTarget" placeholder="Slug do projeto..." style="width: 100%;" />
+                    </div>
+                    <button class="btn primary" type="button" onclick="window.addSlugRule()" style="height: 36px;">Adicionar Regra</button>
                   </div>
 
-                  <label>Regras de Inferência (Formato JSON)</label>
-                  <textarea id="slugRules" rows="12" style="font-family: monospace; font-size: 13px;" placeholder='{\n  "rules": [\n    {\n      "contains": "palavra-chave",\n      "slug": "cliente/projeto"\n    }\n  ]\n}'></textarea>
-                  
-                  <div class="stack" style="margin-top:20px; flex-direction: row; justify-content: flex-end;">
-                    <button class="btn" type="button" onclick="window.reloadSlugRules()">Restaurar</button>
-                    <button class="btn primary" type="button" onclick="window.saveSlugRules()">Salvar Regras</button>
+                  <h3 style="font-size: 14px; margin-top: 24px; margin-bottom: 12px;">Regras Ativas</h3>
+                  <div id="slugListContainer">
+                    <div class="help">Carregando regras...</div>
                   </div>
                 </div>
               </div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cccarv82/freya",
-  "version": "2.5.3",
+  "version": "2.5.5",
   "description": "Personal AI Assistant with local-first persistence",
   "scripts": {
     "health": "node scripts/validate-data.js && node scripts/validate-structure.js",