@fprad0/skill-master-mcp 0.0.12 → 1.0.0

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

@@ -1,76 +1,76 @@
-<!doctype html>
-<html lang="pt-BR">
-<head>
-  <meta charset="utf-8" />
-  <title>Menu Frame 96x24</title>
-  <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;
-    }
-    * { 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 top, rgba(255,255,255,0.06), transparent 35%),
-        var(--bg);
-      background-size: 48px 48px, 48px 48px, 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));
-      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);
-      padding: 20px 24px;
-      white-space: pre;
-      line-height: 1.1;
-      font-size: 13px;
-      border-radius: 8px;
-    }
-    .title {
-      margin: 0 0 16px;
-      color: var(--muted);
-      letter-spacing: 0.12em;
-      text-transform: uppercase;
-      font-size: 12px;
-    }
-  </style>
-</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 ██▇▆▄▃▃▃                                                             ▐
-┗╾────────────────▰▰▰─▱─▱─▱─▱─────────────────────────────────────────────────────────────────╼┛
-
-┌╴───────── 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>
-</body>
+<!doctype html>
+<html lang="pt-BR">
+<head>
+  <meta charset="utf-8" />
+  <title>Menu Frame 96x24</title>
+  <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;
+    }
+    * { 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 top, rgba(255,255,255,0.06), transparent 35%),
+        var(--bg);
+      background-size: 48px 48px, 48px 48px, 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));
+      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);
+      padding: 20px 24px;
+      white-space: pre;
+      line-height: 1.1;
+      font-size: 13px;
+      border-radius: 8px;
+    }
+    .title {
+      margin: 0 0 16px;
+      color: var(--muted);
+      letter-spacing: 0.12em;
+      text-transform: uppercase;
+      font-size: 12px;
+    }
+  </style>
+</head>
+<body>
+  <p class="title">Menu Frame 96x24</p>
+  <pre class="frame">┏╾────────── OVERVIEW▰▱▱──▰───────────────────────────────────────────────────────────────────╼┓
+▌ ▱SKILL MASTER MENU                                                                           ▐
+▌  version 0.0.12 | channel 00.06 | readiness ready                                            ▐
+▌  GLOBAL SKILLS 25/25                                                                         ▐
+▌  bundle 66 | drafts 3 | study 8                                                              ▐
+▌ ▱signal ▃▂▂▄▅▇██ health ██▇▆▄▃▃▃                                                             ▐
+┗╾────────────────▰▰▰─▱─▱─▱─▱─────────────────────────────────────────────────────────────────╼┛
+
+┌╴───────── ACTIONS▱╍╍──▱───────────────────────────────────────╶┐  ┏╾─── DNA-CORE▰───────────╼┓
+│ ╍ACTION MATRIX                                                 │  ▌ ▱DNA CYBER HELIX / ativa ▐
+│  up/down move  enter run  q exit                               │  ▌  dual 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   │
+▌  =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-                              ▐  │  bundle   66  ██████████ │
+▌ ▱desc: Instala uma skill aprendida em .codex/skills do projeto ▐  │ ╍global   25/25 ████████ │
+╰╼═══════════▰▰▰═▱═▱═▱═▱════════════════════════════════════════╾╯  └╴────▱───────────────────╶┘</pre>
+</body>
 </html>