@fprad0/skill-master-mcp 0.0.12 → 1.0.1

package/docs/operations/GUIA_NPM_PUBLICO.md

@@ -1,147 +1,147 @@
-# Guia de Publicacao no npm Publico
-
-## Objetivo
-
-Distribuir o `skill_master` pelo `npmjs.org`, permitindo instalacao direta com:
-
-```bash
-npm install -g @fprad0/skill-master-mcp
-```
-
-ou execucao imediata com:
-
-```bash
-npx -y @fprad0/skill-master-mcp@latest
-```
-
-## Estado atual
-
-Em `2026-06-26`, o pacote:
-
-- ja esta funcional no GitHub Packages privado
-- ja esta publicado no `registry.npmjs.org`
-- ja responde em `npm view @fprad0/skill-master-mcp --registry=https://registry.npmjs.org`
-- ja pode ser instalado com `npm install -g @fprad0/skill-master-mcp`
-- ja pode ser executado com `npx -y @fprad0/skill-master-mcp@latest`
-
-Versao publica validada:
-
-- `0.0.2`
-
-Workflow de referencia:
-
-- `Publish Skill Master to npmjs`
-- run `28244958247`
-- status `success`
-
-## O que isso habilita na pratica
-
-Para uma maquina nova, o caminho mais simples agora e:
-
-```bash
-npm install -g @fprad0/skill-master-mcp
-```
-
-Se a ideia for testar sem install global:
-
-```bash
-npx -y @fprad0/skill-master-mcp@latest
-```
-
-## Validacoes locais recomendadas
-
-### Confirmar login no npmjs
-
-```bash
-npm whoami
-```
-
-### Verificar a versao publicada
-
-```bash
-npm view @fprad0/skill-master-mcp version --registry=https://registry.npmjs.org
-```
-
-### Verificar dist-tags
-
-```bash
-npm view @fprad0/skill-master-mcp dist-tags --json --registry=https://registry.npmjs.org
-```
-
-### Smoke test via npx
-
-```bash
-npx -y @fprad0/skill-master-mcp@latest
-```
-
-## Publicacao local manual
-
-Com login valido no npmjs:
-
-```bash
-npm run publish:npm-public
-```
-
-Esse script publica com:
-
-```bash
-npm publish --access public --registry=https://registry.npmjs.org
-```
-
-## Publicacao por GitHub Actions
-
-O repositorio possui o workflow:
-
-```text
-Publish Skill Master to npmjs
-```
-
-Pre-requisitos:
-
-- secret `NPM_TOKEN` configurado no GitHub
-- token com permissao de publicacao na conta/escopo correto
-- versao do `package.json` ainda nao publicada no npm publico
-
-Fluxo:
-
-1. abrir `Actions` no GitHub
-2. escolher `Publish Skill Master to npmjs`
-3. informar o `ref` a publicar, por exemplo `main` ou uma tag
-4. executar o workflow
-
-O workflow faz:
-
-- `npm ci`
-- `npm run build`
-- `npm test`
-- `npm run check:manifest`
-- `npm run publish:npm-public`
-
-## Riscos e limites
-
-- publicacao no npm publico e visivel publicamente
-- nao e possivel republicar a mesma versao
-- antes de cada novo publish, confirme nome, escopo, metadados e estrategia de suporte
-- o fluxo privado no GitHub Packages continua valido para distribuicao fechada ou controlada
-
-## Checklist rapido depois da release
-
-```bash
-npm view @fprad0/skill-master-mcp version --registry=https://registry.npmjs.org
-```
-
-```bash
-npm view @fprad0/skill-master-mcp dist-tags --json --registry=https://registry.npmjs.org
-```
-
-```bash
-npx -y @fprad0/skill-master-mcp@latest
-```
-
-Se quiser validar instalacao limpa:
-
-```bash
-mkdir skill-master-smoke && cd skill-master-smoke
-npm init -y
-npm install @fprad0/skill-master-mcp --registry=https://registry.npmjs.org
-```
+# Guia de Publicacao no npm Publico
+
+## Objetivo
+
+Distribuir o `skill_master` pelo `npmjs.org`, permitindo instalacao direta com:
+
+```bash
+npm install -g @fprad0/skill-master-mcp
+```
+
+ou execucao imediata com:
+
+```bash
+npx -y @fprad0/skill-master-mcp@latest
+```
+
+## Estado atual
+
+Em `2026-06-26`, o pacote:
+
+- ja esta funcional no GitHub Packages privado
+- ja esta publicado no `registry.npmjs.org`
+- ja responde em `npm view @fprad0/skill-master-mcp --registry=https://registry.npmjs.org`
+- ja pode ser instalado com `npm install -g @fprad0/skill-master-mcp`
+- ja pode ser executado com `npx -y @fprad0/skill-master-mcp@latest`
+
+Versao publica validada:
+
+- `0.0.2`
+
+Workflow de referencia:
+
+- `Publish Skill Master to npmjs`
+- run `28244958247`
+- status `success`
+
+## O que isso habilita na pratica
+
+Para uma maquina nova, o caminho mais simples agora e:
+
+```bash
+npm install -g @fprad0/skill-master-mcp
+```
+
+Se a ideia for testar sem install global:
+
+```bash
+npx -y @fprad0/skill-master-mcp@latest
+```
+
+## Validacoes locais recomendadas
+
+### Confirmar login no npmjs
+
+```bash
+npm whoami
+```
+
+### Verificar a versao publicada
+
+```bash
+npm view @fprad0/skill-master-mcp version --registry=https://registry.npmjs.org
+```
+
+### Verificar dist-tags
+
+```bash
+npm view @fprad0/skill-master-mcp dist-tags --json --registry=https://registry.npmjs.org
+```
+
+### Smoke test via npx
+
+```bash
+npx -y @fprad0/skill-master-mcp@latest
+```
+
+## Publicacao local manual
+
+Com login valido no npmjs:
+
+```bash
+npm run publish:npm-public
+```
+
+Esse script publica com:
+
+```bash
+npm publish --access public --registry=https://registry.npmjs.org
+```
+
+## Publicacao por GitHub Actions
+
+O repositorio possui o workflow:
+
+```text
+Publish Skill Master to npmjs
+```
+
+Pre-requisitos:
+
+- secret `NPM_TOKEN` configurado no GitHub
+- token com permissao de publicacao na conta/escopo correto
+- versao do `package.json` ainda nao publicada no npm publico
+
+Fluxo:
+
+1. abrir `Actions` no GitHub
+2. escolher `Publish Skill Master to npmjs`
+3. informar o `ref` a publicar, por exemplo `main` ou uma tag
+4. executar o workflow
+
+O workflow faz:
+
+- `npm ci`
+- `npm run build`
+- `npm test`
+- `npm run check:manifest`
+- `npm run publish:npm-public`
+
+## Riscos e limites
+
+- publicacao no npm publico e visivel publicamente
+- nao e possivel republicar a mesma versao
+- antes de cada novo publish, confirme nome, escopo, metadados e estrategia de suporte
+- o fluxo privado no GitHub Packages continua valido para distribuicao fechada ou controlada
+
+## Checklist rapido depois da release
+
+```bash
+npm view @fprad0/skill-master-mcp version --registry=https://registry.npmjs.org
+```
+
+```bash
+npm view @fprad0/skill-master-mcp dist-tags --json --registry=https://registry.npmjs.org
+```
+
+```bash
+npx -y @fprad0/skill-master-mcp@latest
+```
+
+Se quiser validar instalacao limpa:
+
+```bash
+mkdir skill-master-smoke && cd skill-master-smoke
+npm init -y
+npm install @fprad0/skill-master-mcp --registry=https://registry.npmjs.org
+```

package/docs/operations/MENU_VISUAL_EVIDENCE_2026-06-28.md

@@ -1,66 +1,66 @@
-# Menu Visual Evidence - 2026-06-28
-
-## Objetivo
-
-Registrar evidencias da passada Reborn cyberpunk pixel art do `skill-master-menu`:
-
-- `overview` com mini-graficos
-- `telemetry` com sparklines e barras
-- `DNA-CORE` como animacao principal no lado direito, evoluida para `DNA CYBER HELIX`, com matriz braille 2x4, canvas mais cheio, paleta cyberpunk harmonica e scan vivo em cadencia mais fluida
-- intro `BOOT-SEQUENCE`, confirmacao visual e estado `running`
-- layout compacto para terminais menores
-- estado visual de execucao antes de transferir para o stream real do comando
-
-## Arquivos de evidencia
-
-Gerados pelo script:
-
-```bash
-node scripts/render-menu-evidence.mjs
-```
-
-Arquivos HTML:
-
-- `docs/operations/assets/menu-frame-large.html`
-- `docs/operations/assets/menu-frame-compact.html`
-- `docs/operations/assets/menu-frame-running.html`
-
-## O que validar visualmente
-
-### Frame grande
-
-- overview com identidade HUD
-- linha de sinal com mini-graficos
-- `DNA-CORE // DNA CYBER HELIX` como painel visual dominante no lado direito
-- dupla helice renderizada em braille/pixel art, com fitas mais encorpadas, pares de base pontilhados e scan em movimento
-- halo pixelado de baixa prioridade ao redor das fitas para preencher melhor o painel sem virar bloco solido
-- paleta por camada: fita cyan, fita ambar, bases azuis, scan branco e grid cinza
-- ciclo de 36 frames com easing senoidal para suavizar a rotacao visual
-- loop visual do menu em 160ms por frame para animacao mais fluida sem alterar os comandos `--run`
-- `details` com hierarquia visual maior que `actions`
-- `telemetry` com barras e sparklines
-
-### Frame compacto
-
-- identidade cyberpunk preservada
-- menu continua selecionavel e legivel
-- DNA-CORE e telemetry continuam presentes em versao condensada
-
-### Running state
-
-- transicao visual clara entre HUD e stream real do comando
-- acao, area e comando ficam explicitos antes da execucao
-
-### Fluxos extras cobertos por teste
-
-- intro `REBORN / SKILL_MASTER`
-- confirmacao `CONFIRMATION GATE`
-- resultado `SUBROUTINE COMPLETE` ou `SUBROUTINE FAILED`
-- saida textual preservada quando nao ha TTY
-
-## Evidencia tecnica
-
-- renderer principal: `bin/lib/menu-core.mjs`
-- fluxo interativo: `bin/skill-master-menu.mjs`
-- testes: `src/menu-core.test.ts`
-- validacao: `npm run check`, `node scripts/verify-menu-actions.mjs`, `npm pack --dry-run`
+# Menu Visual Evidence - 2026-06-28
+
+## Objetivo
+
+Registrar evidencias da passada Reborn cyberpunk pixel art do `skill-master-menu`:
+
+- `overview` com mini-graficos
+- `telemetry` com sparklines e barras
+- `DNA-CORE` como animacao principal no lado direito, evoluida para `DNA CYBER HELIX`, com matriz braille 2x4, canvas mais cheio, paleta cyberpunk harmonica e scan vivo em cadencia mais fluida
+- intro `BOOT-SEQUENCE`, confirmacao visual e estado `running`
+- layout compacto para terminais menores
+- estado visual de execucao antes de transferir para o stream real do comando
+
+## Arquivos de evidencia
+
+Gerados pelo script:
+
+```bash
+node scripts/render-menu-evidence.mjs
+```
+
+Arquivos HTML:
+
+- `docs/operations/assets/menu-frame-large.html`
+- `docs/operations/assets/menu-frame-compact.html`
+- `docs/operations/assets/menu-frame-running.html`
+
+## O que validar visualmente
+
+### Frame grande
+
+- overview com identidade HUD
+- linha de sinal com mini-graficos
+- `DNA-CORE // DNA CYBER HELIX` como painel visual dominante no lado direito
+- dupla helice renderizada em braille/pixel art, com fitas mais encorpadas, pares de base pontilhados e scan em movimento
+- halo pixelado de baixa prioridade ao redor das fitas para preencher melhor o painel sem virar bloco solido
+- paleta por camada: fita cyan, fita ambar, bases azuis, scan branco e grid cinza
+- ciclo de 36 frames com easing senoidal para suavizar a rotacao visual
+- loop visual do menu em 160ms por frame para animacao mais fluida sem alterar os comandos `--run`
+- `details` com hierarquia visual maior que `actions`
+- `telemetry` com barras e sparklines
+
+### Frame compacto
+
+- identidade cyberpunk preservada
+- menu continua selecionavel e legivel
+- DNA-CORE e telemetry continuam presentes em versao condensada
+
+### Running state
+
+- transicao visual clara entre HUD e stream real do comando
+- acao, area e comando ficam explicitos antes da execucao
+
+### Fluxos extras cobertos por teste
+
+- intro `REBORN / SKILL_MASTER`
+- confirmacao `CONFIRMATION GATE`
+- resultado `SUBROUTINE COMPLETE` ou `SUBROUTINE FAILED`
+- saida textual preservada quando nao ha TTY
+
+## Evidencia tecnica
+
+- renderer principal: `bin/lib/menu-core.mjs`
+- fluxo interativo: `bin/skill-master-menu.mjs`
+- testes: `src/menu-core.test.ts`
+- validacao: `npm run check`, `node scripts/verify-menu-actions.mjs`, `npm pack --dry-run`

package/docs/operations/assets/menu-frame-compact.html

@@ -6,12 +6,14 @@
   <style>
     :root {
       color-scheme: dark;
-      --bg: #060606;
-      --panel: #0d0d0d;
-      --grid: rgba(255,255,255,0.06);
-      --line: rgba(255,255,255,0.25);
-      --text: #f3f3f3;
-      --muted: #8f949c;
+      --bg: #050708;
+      --panel: #0b1113;
+      --grid: rgba(112, 230, 229, 0.08);
+      --line: rgba(112, 230, 229, 0.34);
+      --text: #ecffff;
+      --muted: #9aa8ad;
+      --cyan: #70e6e5;
+      --amber: #e5c27a;
     }
     * { box-sizing: border-box; }
     body {
@@ -20,23 +22,24 @@
       background:
         linear-gradient(var(--grid) 1px, transparent 1px),
         linear-gradient(90deg, var(--grid) 1px, transparent 1px),
-        radial-gradient(circle at top, rgba(255,255,255,0.06), transparent 35%),
+        radial-gradient(circle at 70% 10%, rgba(112,230,229,0.13), transparent 36%),
+        radial-gradient(circle at 20% 80%, rgba(229,194,122,0.09), transparent 30%),
         var(--bg);
-      background-size: 48px 48px, 48px 48px, auto, auto;
+      background-size: 42px 42px, 42px 42px, auto, auto, auto;
       color: var(--text);
       font-family: "Courier New", monospace;
       padding: 32px;
     }
     .frame {
       max-width: max-content;
-      background: linear-gradient(180deg, rgba(255,255,255,0.03), rgba(255,255,255,0.01));
+      background: linear-gradient(180deg, rgba(112,230,229,0.05), rgba(255,255,255,0.01));
       border: 1px solid var(--line);
-      box-shadow: 0 0 0 1px rgba(255,255,255,0.04), 0 24px 64px rgba(0,0,0,0.45);
+      box-shadow: 0 0 0 1px rgba(112,230,229,0.08), 0 24px 64px rgba(0,0,0,0.48);
       padding: 20px 24px;
       white-space: pre;
       line-height: 1.1;
       font-size: 13px;
-      border-radius: 8px;
+      border-radius: 10px;
     }
     .title {
       margin: 0 0 16px;
@@ -49,28 +52,28 @@
 </head>
 <body>
   <p class="title">Menu Frame 96x24</p>
-  <pre class="frame">┏╾────────── OVERVIEW▰▱▱──▰───────────────────────────────────────────────────────────────────╼┓
-▌ ▱SKILL MASTER MENU                                                                           ▐
-▌  version 0.0.11 | channel 00.05 | readiness ready                                            ▐
-▌  GLOBAL SKILLS 13/13                                                                         ▐
-▌  bundle 54 | drafts 3 | study 8                                                              ▐
-▌ ▱signal ██▇▅▄▃▃▃ health ██▇▆▄▃▃▃                                                             ▐
-┗╾────────────────▰▰▰─▱─▱─▱─▱─────────────────────────────────────────────────────────────────╼┛
+  <pre class="frame">+----------- OVERVIEW#..--#--------------------------------------------------------------------+
+| .SKILL MASTER MENU                                                                           |
+|  version 1.0.1 | channel 1.0.1 | readiness ready                                             |
+|  GLOBAL SKILLS 25/25                                                                         |
+|  bundle 69 | drafts 3 | study 8                                                              |
+| .signal :::-=### health ###=-:::                                                             |
++-----------------###-.-.-.-.------------------------------------------------------------------+
 
-┌╴───────── ACTIONS▱╍╍──▱───────────────────────────────────────╶┐  ┏╾─── DNA-CORE▰───────────╼┓
-│ ╍ACTION GRID                                                   │  ▌ ▱DNA CYBER HELIX / ativa ▐
-│  up/down move  enter run  q exit                               │  ▌   ⠁  ⠸⣿⣿⡁     ⠁   ⡸⡻⡻    ▐
-│  . Rejeitar skill candidata                                    │  ▌       ⠈⠻⢿⣷⣦⣄⣀⠄⢀⣤⣴⡾⠞⠊     ▐
-│  . Ativar skill aprendida no workspace                         │  ▌   ⠁     ⠁⣈⣽⣿⣿⣿⣿⣭⣅⡀  ⠁    ▐
-│  &gt; Ativar skill aprendida global                               │  ▌       ⣀⣴⣿⠿⠛⠛⠓⠒⠛⠛⠻⢿⣷⣤⡀    ▐
-│ ╍. Abrir resumo para Notion                                    │  ▌ ▱ ⠁  ⠸⣿⣿⡁     ⠁   ⡹⡿⡿    ▐
-└╴───────────▱▱▱─╍─╍─╍─╍────────────────────────────────────────╶┘  ┗╾────▰───────────────────╼┛
-╭╼═════════ DETAILS▰▱▱══▰═══════════════════════════════════════╾╮  ┌╴─── TELEMETRY▱──────────╶┐
-▌ ▱DETAIL FOCUS                                                  ▐  │ ╍SYSTEM WINDOWS          │
-▌  Ativar skill aprendida global                                 ▐  │  selected area  ativacao │
-▌  area ativacao-skill | action 21/22                            ▐  │  dominant skill  fronten │
-▌  -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=                              ▐  │  bundle   54  ██████████ │
-▌ ▱Instala uma skill aprendida em CODEX_HOME/skills ou           ▐  │ ╍global   13/13 ████████ │
-╰╼═══════════▰▰▰═▱═▱═▱═▱════════════════════════════════════════╾╯  └╴────▱───────────────────╶┘</pre>
++---------- ACTIONS#..--#----------------------------------------+  +---- DNA-CORE#------------+
+| .ACTION MATRIX                                                 |  | .DNA CYBER HELIX / ativa |
+|  up/down move  enter run  q exit                               |  |  fine strand / focus     |
+|  window 21/23 | visible 4                                      |  |   *    ************   *  |
+|  - Manter skill candidata para estudo                          |  |         ***********      |
+|  - Rejeitar skill candidata                                    |  |   *    * *********    *  |
+| .&gt; Ativar skill aprendida no workspace                         |  | .         ********       |
++------------###-.-.-.-.-----------------------------------------+  +-----#--------------------+
++-========= DETAILS#..==#=======================================-+  +---- TELEMETRY#-----------+
+| .DETAIL FOCUS                                                  |  | .SYSTEM WINDOWS          |
+|  Ativar skill aprendida no workspace                           |  |  [AREA] ativacao-skill   |
+|  [AREA] ativacao-skill | action 21/23                          |  |  [LEAD] frontend-ui 22   |
+|  [WRITES-LOCAL] [RISK:MEDIUM] [CONFIRM] [TTY]                  |  |  bundle   69  ########## |
+| .=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-                              |  | .global   25/25 ######## |
++-===========###=.=.=.=.========================================-+  +-----#--------------------+</pre>
 </body>
 </html>

package/docs/operations/assets/menu-frame-dna-hero.html

@@ -0,0 +1,87 @@
+<!doctype html>
+<html lang="pt-BR">
+<head>
+  <meta charset="utf-8" />
+  <title>DNA Hero Boot</title>
+  <style>
+    :root {
+      color-scheme: dark;
+      --bg: #050708;
+      --panel: #0b1113;
+      --grid: rgba(112, 230, 229, 0.08);
+      --line: rgba(112, 230, 229, 0.34);
+      --text: #ecffff;
+      --muted: #9aa8ad;
+      --cyan: #70e6e5;
+      --amber: #e5c27a;
+    }
+    * { box-sizing: border-box; }
+    body {
+      margin: 0;
+      min-height: 100vh;
+      background:
+        linear-gradient(var(--grid) 1px, transparent 1px),
+        linear-gradient(90deg, var(--grid) 1px, transparent 1px),
+        radial-gradient(circle at 70% 10%, rgba(112,230,229,0.13), transparent 36%),
+        radial-gradient(circle at 20% 80%, rgba(229,194,122,0.09), transparent 30%),
+        var(--bg);
+      background-size: 42px 42px, 42px 42px, auto, auto, auto;
+      color: var(--text);
+      font-family: "Courier New", monospace;
+      padding: 32px;
+    }
+    .frame {
+      max-width: max-content;
+      background: linear-gradient(180deg, rgba(112,230,229,0.05), rgba(255,255,255,0.01));
+      border: 1px solid var(--line);
+      box-shadow: 0 0 0 1px rgba(112,230,229,0.08), 0 24px 64px rgba(0,0,0,0.48);
+      padding: 20px 24px;
+      white-space: pre;
+      line-height: 1.1;
+      font-size: 13px;
+      border-radius: 10px;
+    }
+    .title {
+      margin: 0 0 16px;
+      color: var(--muted);
+      letter-spacing: 0.12em;
+      text-transform: uppercase;
+      font-size: 12px;
+    }
+  </style>
+</head>
+<body>
+  <p class="title">DNA Hero Boot</p>
+  <pre class="frame">+----------- DNA-HERO#----#--------------------------------------------------------------------------------------------+
+| .SKILL_MASTER DNA ONLINE                                                                                             |
+|  boot hero / intelligence configuration / terminal-safe animation                                                    |
+|  package @fprad0/skill-master-mcp | version 1.0.1 | channel 1.0.1                                                    |
+|  DNA signal ===-:..:-=###==-=====::..:-==                                                                            |
+|                        DNA CYBER HELIX / geral                                                                       |
+|                        luminous fine helix / low flicker                                                             |
+|                         *    *    *    *    *    *  **************** *    *    *    *    *                           |
+|                                                   ******************                                                 |
+|                         *    *    *    *    *    * ******  *   ***** *    *    *    *    *                           |
+|                                                      ************                                                    |
+|                                                       ************                                                   |
+|                         *    *    *    *    *    * ***************** *    *    *    *    *                           |
+|                                                    ***     *     ***                                                 |
+|                         *    *    *    *    *    *  ********* ****   *    *    *    *    *                           |
+|                                                        ********                                                      |
+|                                                      ***** ********                                                  |
+|                         *    *    *    *    *    * ***************** *    *    *    *    *                           |
+|                                                   ****           ***                                                 |
+|                        [HELIX] frames 5/48 | global 25/25                                                            |
+|  &lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/ |
+|  ONLINE | global 25/25 | bundle 69                                                                                   |
+|                                                                                                                      |
+|                                                                                                                      |
+|                                                                                                                      |
+|                                                                                                                      |
+|                                                                                                                      |
+|                                                                                                                      |
+|                                                                                                                      |
+| .                                                                                                                    |
++---------------------###----------------------------------------------------------------------------------------------+</pre>
+</body>
+</html>