npm - @fprad0/skill-master-mcp - Versions diffs - 0.0.12 → 1.0.0 - Mend

@fprad0/skill-master-mcp 0.0.12 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (331) hide show

package/docs/operations/assets/menu-frame-large.html CHANGED Viewed

@@ -1,84 +1,84 @@
-<!doctype html>
-<html lang="pt-BR">
-<head>
-  <meta charset="utf-8" />
-  <title>Menu Frame 120x32</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 120x32</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 ██▇▆▄▃▃▃▄▄▄▄                                                                           ▐
-▌ ▱moral-core 10 | frontend-ui 19 | backend-data 10 | ops-clients 12 | knowledge 2                                     ▐
-┗╾────────────────────▰▰▰─▱─▱─▱─▱─────────────────────────────────────────────────────────────────────────────────────╼┛
-┌╴────────── ACTIONS▱╍╍──▱────────────────────────────────────────────────────╶┐  ┏╾───── DNA-CORE▰───────────────────╼┓
-│ ╍ACTION GRID                                                                 │  ▌ ▱DNA CYBER HELIX / diagnostico     ▐
-│  up/down move  enter run  q exit                                             │  ▌   ⠁    ⠸⣿⣿⣄ ⠄ ⠅ ⠄ ⠄ ⠅ ⠄ ⠄ ⡽⡻⡻   ⠁  ▐
-│  . Status local                                                              │  ▌         ⠈⠛⠿⢿⣷⣶⣤⣄⣀⣀ ⢀⢀⣀⣤⣴⠶⠟⠛⠉       ▐
-│  &gt; Doctor do menu e clientes MCP                                             │  ▌   ⠁     ⠁    ⢉⣙⣿⣿⠿⣿⣿⣿⣭⣅⣀⡀ ⠁     ⠁  ▐
-│  . Rodar gate completo [off]                                                 │  ▌         ⢀⣤⣶⣿⠟⠋⠉⠁⠈ ⠈ ⠉⠙⠛⠻⢿⣷⣦⣄       ▐
-│  . Rodar build [off]                                                         │  ▌   ⠁    ⠰⣿⣿⡛⠒⠒⠒⠓⠒⠒⠒⠒⠒⠓⠒⠒⠒⠒⠚⡻⣿⡷   ⠁  ▐
-│  . Validar pacote no npm publico                                             │  ▌         ⠈⠻⠿⣿⣶⣦⣤⣠⡀⠠ ⠠ ⣠⣠⣤⡶⠾⠚⠊       ▐
-│  . Atualizar pacote global via npm                                           │  ▌   ⠁     ⠁   ⠈⠉⣛⣻⣿⣿⣶⣾⣿⣯⣉⡀  ⠁     ⠁  ▐
-│  . Configurar registry privado GitHub Packages                               │  ▌          ⣀⣤⣶⠾⠛⠋⠉   ⠉⠉⠛⠻⠿⣿⣶⣤⣀       ▐
-│  . Modo de ativacao atual                                                    │  ▌   ⠁    ⢰⣿⣿⠉ ⠈ ⠉ ⠈ ⠈ ⠉ ⠈ ⠈⠉⢻⢿⢷   ⠁  ▐
-│ ╍                                                                            │  ▌         ⠙⠿⣿⣶⣦⣔ ⠐ ⠐ ⠐ ⠐⢀⣰⣤⡶⠷⠓⠁      ▐
-└╴─────────────▱▱▱─╍─╍─╍─╍────────────────────────────────────────────────────╶┘  ▌ ▱frames 8/36  global 13/13         ▐
-╭╼══════════ DETAILS▰▱▱══▰════════════════════════════════════════════════════╾╮  ┗╾──────▰▰▰─────────────────────────╼┛
-▌ ▱DETAIL FOCUS                                                                ▐  ┌╴───── TELEMETRY▱──────────────────╶┐
-▌  Doctor do menu e clientes MCP                                               ▐  │ ╍SYSTEM WINDOWS                    │
-▌  area diagnostico | action 2/22                                              ▐  │  selected area  diagnostico        │
-▌  -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=                                            ▐  │  dominant skill  frontend-ui 19    │
-▌  Valida pacote, binarios, skills globais e registros em Codex, Claude, Gemin ▐  │  bundle   54  ████████████████     │
-▌  resultado: Mostra um relatorio GO/NO-GO com proximos comandos recomendados. ▐  │  global   13/13 ████████████████   │
-▌ ▱exec: /usr/bin/node /tmp/skill-master/bin/skill-master-doctor.mjs           ▐  │ ╍skills   ▅▇██▇▅▄▄▄▄▅▅             │
-╰╼═════════════▰▰▰═▱═▱═▱═▱════════════════════════════════════════════════════╾╯  └╴──────▱▱▱─────────────────────────╶┘</pre>
-</body>
+<!doctype html>
+<html lang="pt-BR">
+<head>
+  <meta charset="utf-8" />
+  <title>Menu Frame 120x32</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 120x32</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                                                                                      ▐
+▌  [FOCUS] diagnostico / doctor                                                                                        ▐
+▌  signal ▃▂▂▄▅▇██▇▅▄▄   health ██▇▆▄▃▃▃▄▄▄▄                                                                           ▐
+▌ ▱moral-core 10 | frontend-ui 22 | backend-data 19 | ops-clients 12 | knowledge 2                                     ▐
+┗╾────────────────────▰▰▰─▱─▱─▱─▱─────────────────────────────────────────────────────────────────────────────────────╼┛
+┌╴────────── ACTIONS▱╍╍──▱────────────────────────────────────────────────────────╶┐  ┏╾──── DNA-CORE▰────────────────╼┓
+│ ╍ACTION MATRIX                                                                   │  ▌ ▱DNA CYBER HELIX / diagnostico ▐
+│  up/down move  enter run  q exit                                                 │  ▌  dense helix / low flicker     ▐
+│  window 2/23 | visible 8                                                         │  ▌   ⠁    ⢱⣿⣿⣿⠟⠁   ⠁⠁  ⠻⣿⣿⣿⣷  ⠁   ▐
+│  · Status local                                                                  │  ▌        ⢿⣿⣿⣿⣷⣦⣤⣤⣤⣤⣤⣤⣤⣤⣾⣿⣿⡿      ▐
+│  &gt; Doctor do menu e clientes MCP  ◢                                              │  ▌   ⠄    ⠄⠙⢿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠿⠋   ⠄   ▐
+│  · Rodar gate completo [off]                                                     │  ▌           ⠙⠻⣿⣿⣿⣿⣿⣿⣿⣿⣯⣄⡀        ▐
+│  · Rodar build [off]                                                             │  ▌         ⢀⣴⣿⣿⣿⣿⠿⠻⢿⣿⣿⣿⣿⣿⣿⣦⡀      ▐
+│  · Validar pacote no npm publico                                                 │  ▌   ⠁    ⢱⣿⣿⣿⠟⠉⠉⠉⠉⠉⠉⠙⠻⢿⣿⣿⣿⣿  ⠁   ▐
+│  · Atualizar pacote global via npm                                               │  ▌        ⢸⣿⣿⣿⣷⣦⣀⣀⣀⣁⣀⣀⣀⣠⣾⣿⣿⡿      ▐
+│  · Configurar registry privado GitHub Packages                                   │  ▌ ▱ ⠄    ⠄⠙⢿⣿⣿⣿⣿⣿⣶⣤⣤⣴⣾⣿⣿⠿⠋   ⠄   ▐
+│ ╍· Modo de ativacao atual                                                        │  ┗╾─────▰────────────────────────╼┛
+└╴──────────────▱▱▱─╍─╍─╍─╍───────────────────────────────────────────────────────╶┘  ┌╴──── TELEMETRY▱───────────────╶┐
+╭╼══════════ DETAILS▰▱▱══▰════════════════════════════════════════════════════════╾╮  │ ╍SYSTEM WINDOWS                │
+▌ ▱DETAIL FOCUS                                                                    ▐  │  [AREA] diagnostico            │
+▌  Doctor do menu e clientes MCP                                                   ▐  │  [LEAD] frontend-ui 22         │
+▌  [AREA] diagnostico | action 2/23                                                ▐  │  bundle   66  ████████████████ │
+▌  =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-                                                ▐  │  global   25/25 ██████████████ │
+▌  desc: Valida pacote, binarios, skills globais e registros em Codex, Claude      ▐  │  [LINK] cx+ cl+ gm+ ag+        │
+▌ ▱exec: /usr/bin/node /tmp/skill-master/bin/skill-master-doctor.mjs               ▐  │ ╍skills   ▁▂▄▅▇▇▇▆▅▄▄▅         │
+╰╼══════════════▰▰▰═▱═▱═▱═▱═══════════════════════════════════════════════════════╾╯  └╴─────▱────────────────────────╶┘</pre>
+</body>
 </html>

package/docs/operations/assets/menu-frame-running.html CHANGED Viewed

@@ -1,80 +1,80 @@
-<!doctype html>
-<html lang="pt-BR">
-<head>
-  <meta charset="utf-8" />
-  <title>Menu Running State</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 Running State</p>
-  <pre class="frame">╔╼══════════ RUNNING▰════▰════════════════════════════════════════════════════════════════════════════════════════════╾╗
-▌▌▱SKILL_MASTER WORKFLOW ONLINE                                                                                       ▐▐
-▌▌ area diagnostico | launching Doctor do menu e clientes MCP                                                         ▐▐
-▌▌▰pulse █▇▅▄▃▃▄▄▅▄▃▂▂▂▄▆▇█                                                                                           ▐▐
-▌▌ &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;=/===/▐▐
-▌▌ .    |  .   +   .       .    +  .       .     + .       .      +.       .       +       .       .+      .       . +▐▐
-▌▌▰           +                +                +                +                +                +                + ▐▐
-▌▌ -  - |-  -+ -  -  -  -  -  -  -  -  -  -  - +-  -  -  -  -  -+ -  -  -  -  -  -  -  -  -  -  - +-  -  -  -  -  -+ -▐▐
-▌▌          +                +                +                +                +                +                +   ▐▐
-▌▌▰.    |  +       .       .+      .       . +     .       .  +    .       .   +   .       .    +  .       .     + .  ▐▐
-▌▌        +                +                +                +                +                +                +     ▐▐
-▌▌      |+                +                +                +                +                +                +      ▐▐
-▌▌▰     +                +                +                +                +                +                +       ▐▐
-▌▌                                                                                                                    ▐▐
-▌▌ Valida pacote, binarios, skills globais e registros em Codex, Claude, Gemini e Antigravity.                        ▐▐
-▌▌▰resultado esperado: Mostra um relatorio GO/NO-GO com proximos comandos recomendados.                               ▐▐
-▌▌ exec: /usr/bin/node /tmp/skill-master/bin/skill-master-doctor.mjs                                                  ▐▐
-▌▌                                                                                                                    ▐▐
-▌▌▰handoff: HUD -&gt; stream real do comando                                                                             ▐▐
-▌▌                                                                                                                    ▐▐
-▌▌                                                                                                                    ▐▐
-▌▌▰                                                                                                                   ▐▐
-▌▌                                                                                                                    ▐▐
-▌▌                                                                                                                    ▐▐
-▌▌▰                                                                                                                   ▐▐
-▌▌▱                                                                                                                   ▐▐
-╚╼════════════════════▰▰▰═════════════════════════════════════════════════════════════════════════════════════════════╾╝</pre>
-</body>
+<!doctype html>
+<html lang="pt-BR">
+<head>
+  <meta charset="utf-8" />
+  <title>Menu Running State</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 Running State</p>
+  <pre class="frame">╔╼══════════ RUNNING▰════▰════════════════════════════════════════════════════════════════════════════════════════════╾╗
+▌▌▱SKILL_MASTER WORKFLOW ONLINE                                                                                       ▐▐
+▌▌ area diagnostico | launching Doctor do menu e clientes MCP                                                         ▐▐
+▌▌▰pulse ▂▂▄▆▇█▇▆▅▄▄▄▅▅▅▄▂▁                                                                                           ▐▐
+▌▌ &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;=/===/▐▐
+▌▌ .    |  .   +   .       .    +  .       .     + .       .      +.       .       +       .       .+      .       . +▐▐
+▌▌▰           +                +                +                +                +                +                + ▐▐
+▌▌ -  - |-  -+ -  -  -  -  -  -  -  -  -  -  - +-  -  -  -  -  -+ -  -  -  -  -  -  -  -  -  -  - +-  -  -  -  -  -+ -▐▐
+▌▌          +                +                +                +                +                +                +   ▐▐
+▌▌▰.    |  +       .       .+      .       . +     .       .  +    .       .   +   .       .    +  .       .     + .  ▐▐
+▌▌        +                +                +                +                +                +                +     ▐▐
+▌▌      |+                +                +                +                +                +                +      ▐▐
+▌▌▰     +                +                +                +                +                +                +       ▐▐
+▌▌                                                                                                                    ▐▐
+▌▌ Valida pacote, binarios, skills globais e registros em Codex, Claude Desktop, Claude Code, Gemini e Antigravity.   ▐▐
+▌▌▰resultado esperado: Mostra um relatorio GO/NO-GO com proximos comandos recomendados.                               ▐▐
+▌▌ exec: /usr/bin/node /tmp/skill-master/bin/skill-master-doctor.mjs                                                  ▐▐
+▌▌                                                                                                                    ▐▐
+▌▌▰handoff: HUD -&gt; stream real do comando                                                                             ▐▐
+▌▌                                                                                                                    ▐▐
+▌▌                                                                                                                    ▐▐
+▌▌▰                                                                                                                   ▐▐
+▌▌                                                                                                                    ▐▐
+▌▌                                                                                                                    ▐▐
+▌▌▰                                                                                                                   ▐▐
+▌▌▱                                                                                                                   ▐▐
+╚╼════════════════════▰▰▰═════════════════════════════════════════════════════════════════════════════════════════════╾╝</pre>
+</body>
 </html>

package/docs/operations/cross-platform-auth-transfer/ANALISE_COMPATIBILIDADE_MCP_2026-06-28.md CHANGED Viewed

@@ -1,140 +1,140 @@
-# Analise - Compatibilidade MCP Windows Linux macOS
-Data: 2026-06-28
-Projeto: `@fprad0/skill-master-mcp`
-Status: correcoes aplicadas localmente, publicacao proibida neste computador
-## Problema
-O `skill_master` podia ser instalado corretamente por npm, mas alguns clientes MCP nao conseguiam iniciar o servidor. O ponto mais provavel era a configuracao dos clientes usando:
-```text
-command = "skill-master-mcp"
-```
-Esse formato depende do `PATH` do processo que abriu o cliente. Em apps desktop no Windows e macOS, e tambem em ambientes Linux com launchers grafico/systemd, o `PATH` pode nao conter a pasta global do npm. Resultado: o pacote esta instalado, mas o cliente diz que nao consegue autorizar/iniciar/encontrar o MCP.
-## Limite importante
-Nenhum pacote npm deve burlar autorizacoes do sistema operacional ou do cliente MCP. A correcao segura e suportada e:
-- registrar o servidor com executavel Node absoluto;
-- passar o entrypoint `bin/skill-master.mjs` absoluto em `args`;
-- manter bootstrap explicito para alterar configs de usuario;
-- diagnosticar configuracoes antigas como `path-bin` ou `launcher`.
-## Correcao aplicada
-Foi criado um modulo compartilhado:
-```text
-bin/lib/client-config.mjs
-```
-Ele centraliza:
-- paths padrao de Codex, Claude Desktop, Gemini e Antigravity;
-- geracao de config MCP robusta;
-- bloco TOML do Codex;
-- snippets JSON;
-- merge de configs JSON;
-- avaliacao de configs robustas vs antigas.
-Novo padrao de servidor:
-```json
-{
-  "command": "/caminho/absoluto/para/node",
-  "args": ["/caminho/absoluto/para/bin/skill-master.mjs"],
-  "env": {
-    "SKILL_MASTER_UPDATE_CHANNEL": "stable"
-  }
-}
-```
-No Codex:
-```toml
-[mcp_servers.skill_master]
-command = "/caminho/absoluto/para/node"
-args = ["/caminho/absoluto/para/bin/skill-master.mjs"]
-startup_timeout_sec = 120
-[mcp_servers.skill_master.env]
-SKILL_MASTER_UPDATE_CHANNEL = "stable"
-```
-## Arquivos alterados
-```text
-bin/lib/client-config.mjs
-bin/lib/menu-core.mjs
-bin/skill-master-bootstrap-global.mjs
-bin/skill-master-doctor.mjs
-bin/skill-master-register-clients.mjs
-scripts/verify-menu-actions.mjs
-src/client-config.test.ts
-src/menu-core.test.ts
-package.json
-README.md
-CHANGELOG.md
-docs/operations/GUIA_MULTI_COMPUTADOR.md
-```
-Tambem existem arquivos de planejamento visual anteriores em:
-```text
-docs/operations/reborn-menu-cyberpunk-transfer/
-docs/prompt-tasks/PROMPT_TASK_012_MENU_CYBERPUNK_PIXEL_FRAME.md
-docs/prompt-tasks/PROMPT_TASK_013_MENU_FLUID_DNA_ANIMATION.md
-docs/prompt-tasks/PROMPT_TASK_014_MENU_FUNCTIONAL_PARITY_QA.md
-docs/prompt-tasks/PROMPT_TASK_015_TRANSFER_RELEASE_HANDOFF.md
-```
-## Validacao executada localmente
-```powershell
-npm install
-npm run check
-node bin/skill-master-register-clients.mjs --write-snippets --snippets-dir .tmp-client-snippets
-node bin/skill-master-menu.mjs --status
-node bin/skill-master-doctor.mjs
-```
-Resultado:
-- build passou;
-- 12 arquivos de teste passaram;
-- 55 testes passaram;
-- matriz de 22 acoes do menu passou;
-- manifestos passaram;
-- snippets gerados usam Node absoluto + `bin/skill-master.mjs` absoluto.
-## O que validar no computador autorizado
-```powershell
-git status --short
-npm install
-npm run check
-npm pack --dry-run
-node bin/skill-master-register-clients.mjs --write-snippets --snippets-dir .tmp-client-snippets
-node bin/skill-master-doctor.mjs
-```
-Depois de publicar e instalar globalmente:
-```powershell
-npm install -g @fprad0/skill-master-mcp@latest
-skill-master-register-clients --apply-all --force
-skill-master-menu --run doctor
-```
-Reiniciar Codex depois do registro.
-## Riscos restantes
-- O usuario ainda precisa permitir que o cliente MCP leia sua configuracao local.
-- macOS Gatekeeper nao deve bloquear scripts npm comuns, mas ambientes corporativos podem ter politicas proprias.
-- Windows pode exigir que Node esteja instalado e acessivel no caminho absoluto gravado.
-- Se o usuario mover/remover a instalacao global depois do registro, e preciso rodar `skill-master-register-clients --apply-all --force` novamente.
+# Analise - Compatibilidade MCP Windows Linux macOS
+Data: 2026-06-28
+Projeto: `@fprad0/skill-master-mcp`
+Status: correcoes aplicadas localmente, publicacao proibida neste computador
+## Problema
+O `skill_master` podia ser instalado corretamente por npm, mas alguns clientes MCP nao conseguiam iniciar o servidor. O ponto mais provavel era a configuracao dos clientes usando:
+```text
+command = "skill-master-mcp"
+```
+Esse formato depende do `PATH` do processo que abriu o cliente. Em apps desktop no Windows e macOS, e tambem em ambientes Linux com launchers grafico/systemd, o `PATH` pode nao conter a pasta global do npm. Resultado: o pacote esta instalado, mas o cliente diz que nao consegue autorizar/iniciar/encontrar o MCP.
+## Limite importante
+Nenhum pacote npm deve burlar autorizacoes do sistema operacional ou do cliente MCP. A correcao segura e suportada e:
+- registrar o servidor com executavel Node absoluto;
+- passar o entrypoint `bin/skill-master.mjs` absoluto em `args`;
+- manter bootstrap explicito para alterar configs de usuario;
+- diagnosticar configuracoes antigas como `path-bin` ou `launcher`.
+## Correcao aplicada
+Foi criado um modulo compartilhado:
+```text
+bin/lib/client-config.mjs
+```
+Ele centraliza:
+- paths padrao de Codex, Claude Desktop, Gemini e Antigravity;
+- geracao de config MCP robusta;
+- bloco TOML do Codex;
+- snippets JSON;
+- merge de configs JSON;
+- avaliacao de configs robustas vs antigas.
+Novo padrao de servidor:
+```json
+{
+  "command": "/caminho/absoluto/para/node",
+  "args": ["/caminho/absoluto/para/bin/skill-master.mjs"],
+  "env": {
+    "SKILL_MASTER_UPDATE_CHANNEL": "stable"
+  }
+}
+```
+No Codex:
+```toml
+[mcp_servers.skill_master]
+command = "/caminho/absoluto/para/node"
+args = ["/caminho/absoluto/para/bin/skill-master.mjs"]
+startup_timeout_sec = 120
+[mcp_servers.skill_master.env]
+SKILL_MASTER_UPDATE_CHANNEL = "stable"
+```
+## Arquivos alterados
+```text
+bin/lib/client-config.mjs
+bin/lib/menu-core.mjs
+bin/skill-master-bootstrap-global.mjs
+bin/skill-master-doctor.mjs
+bin/skill-master-register-clients.mjs
+scripts/verify-menu-actions.mjs
+src/client-config.test.ts
+src/menu-core.test.ts
+package.json
+README.md
+CHANGELOG.md
+docs/operations/GUIA_MULTI_COMPUTADOR.md
+```
+Tambem existem arquivos de planejamento visual anteriores em:
+```text
+docs/operations/reborn-menu-cyberpunk-transfer/
+docs/prompt-tasks/PROMPT_TASK_012_MENU_CYBERPUNK_PIXEL_FRAME.md
+docs/prompt-tasks/PROMPT_TASK_013_MENU_FLUID_DNA_ANIMATION.md
+docs/prompt-tasks/PROMPT_TASK_014_MENU_FUNCTIONAL_PARITY_QA.md
+docs/prompt-tasks/PROMPT_TASK_015_TRANSFER_RELEASE_HANDOFF.md
+```
+## Validacao executada localmente
+```powershell
+npm install
+npm run check
+node bin/skill-master-register-clients.mjs --write-snippets --snippets-dir .tmp-client-snippets
+node bin/skill-master-menu.mjs --status
+node bin/skill-master-doctor.mjs
+```
+Resultado:
+- build passou;
+- 12 arquivos de teste passaram;
+- 55 testes passaram;
+- matriz de 22 acoes do menu passou;
+- manifestos passaram;
+- snippets gerados usam Node absoluto + `bin/skill-master.mjs` absoluto.
+## O que validar no computador autorizado
+```powershell
+git status --short
+npm install
+npm run check
+npm pack --dry-run
+node bin/skill-master-register-clients.mjs --write-snippets --snippets-dir .tmp-client-snippets
+node bin/skill-master-doctor.mjs
+```
+Depois de publicar e instalar globalmente:
+```powershell
+npm install -g @fprad0/skill-master-mcp@latest
+skill-master-register-clients --apply-all --force
+skill-master-menu --run doctor
+```
+Reiniciar Codex depois do registro.
+## Riscos restantes
+- O usuario ainda precisa permitir que o cliente MCP leia sua configuracao local.
+- macOS Gatekeeper nao deve bloquear scripts npm comuns, mas ambientes corporativos podem ter politicas proprias.
+- Windows pode exigir que Node esteja instalado e acessivel no caminho absoluto gravado.
+- Se o usuario mover/remover a instalacao global depois do registro, e preciso rodar `skill-master-register-clients --apply-all --force` novamente.