@cccarv82/freya 2.5.3 → 2.5.4

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>

package/package.json

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