@fprad0/skill-master-mcp 0.0.10 → 0.0.11

package/docs/skill-candidates/v0.0.11/typescript-expert/scripts/ts_diagnostic.py

@@ -0,0 +1,203 @@
+#!/usr/bin/env python3
+"""
+TypeScript Project Diagnostic Script
+Analyzes TypeScript projects for configuration, performance, and common issues.
+"""
+
+import subprocess
+import sys
+import os
+import json
+from pathlib import Path
+
+def run_cmd(cmd: str) -> str:
+    """Run shell command and return output."""
+    try:
+        result = subprocess.run(cmd, shell=True, capture_output=True, text=True)
+        return result.stdout + result.stderr
+    except Exception as e:
+        return str(e)
+
+def check_versions():
+    """Check TypeScript and Node versions."""
+    print("\n📦 Versions:")
+    print("-" * 40)
+    
+    ts_version = run_cmd("npx tsc --version 2>/dev/null").strip()
+    node_version = run_cmd("node -v 2>/dev/null").strip()
+    
+    print(f"  TypeScript: {ts_version or 'Not found'}")
+    print(f"  Node.js: {node_version or 'Not found'}")
+
+def check_tsconfig():
+    """Analyze tsconfig.json settings."""
+    print("\n⚙️ TSConfig Analysis:")
+    print("-" * 40)
+    
+    tsconfig_path = Path("tsconfig.json")
+    if not tsconfig_path.exists():
+        print("⚠️ tsconfig.json not found")
+        return
+    
+    try:
+        with open(tsconfig_path) as f:
+            config = json.load(f)
+        
+        compiler_opts = config.get("compilerOptions", {})
+        
+        # Check strict mode
+        if compiler_opts.get("strict"):
+            print("✅ Strict mode enabled")
+        else:
+            print("⚠️ Strict mode NOT enabled")
+        
+        # Check important flags
+        flags = {
+            "noUncheckedIndexedAccess": "Unchecked index access protection",
+            "noImplicitOverride": "Implicit override protection",
+            "skipLibCheck": "Skip lib check (performance)",
+            "incremental": "Incremental compilation"
+        }
+        
+        for flag, desc in flags.items():
+            status = "✅" if compiler_opts.get(flag) else "⚪"
+            print(f"  {status} {desc}: {compiler_opts.get(flag, 'not set')}")
+        
+        # Check module settings
+        print(f"\n  Module: {compiler_opts.get('module', 'not set')}")
+        print(f"  Module Resolution: {compiler_opts.get('moduleResolution', 'not set')}")
+        print(f"  Target: {compiler_opts.get('target', 'not set')}")
+        
+    except json.JSONDecodeError:
+        print("❌ Invalid JSON in tsconfig.json")
+
+def check_tooling():
+    """Detect TypeScript tooling ecosystem."""
+    print("\n🛠️ Tooling Detection:")
+    print("-" * 40)
+    
+    pkg_path = Path("package.json")
+    if not pkg_path.exists():
+        print("⚠️ package.json not found")
+        return
+    
+    try:
+        with open(pkg_path) as f:
+            pkg = json.load(f)
+        
+        all_deps = {**pkg.get("dependencies", {}), **pkg.get("devDependencies", {})}
+        
+        tools = {
+            "biome": "Biome (linter/formatter)",
+            "eslint": "ESLint",
+            "prettier": "Prettier",
+            "vitest": "Vitest (testing)",
+            "jest": "Jest (testing)",
+            "turborepo": "Turborepo (monorepo)",
+            "turbo": "Turbo (monorepo)",
+            "nx": "Nx (monorepo)",
+            "lerna": "Lerna (monorepo)"
+        }
+        
+        for tool, desc in tools.items():
+            for dep in all_deps:
+                if tool in dep.lower():
+                    print(f"  ✅ {desc}")
+                    break
+                    
+    except json.JSONDecodeError:
+        print("❌ Invalid JSON in package.json")
+
+def check_monorepo():
+    """Check for monorepo configuration."""
+    print("\n📦 Monorepo Check:")
+    print("-" * 40)
+    
+    indicators = [
+        ("pnpm-workspace.yaml", "PNPM Workspace"),
+        ("lerna.json", "Lerna"),
+        ("nx.json", "Nx"),
+        ("turbo.json", "Turborepo")
+    ]
+    
+    found = False
+    for file, name in indicators:
+        if Path(file).exists():
+            print(f"  ✅ {name} detected")
+            found = True
+    
+    if not found:
+        print("  ⚪ No monorepo configuration detected")
+
+def check_type_errors():
+    """Run quick type check."""
+    print("\n🔍 Type Check:")
+    print("-" * 40)
+    
+    result = run_cmd("npx tsc --noEmit 2>&1 | head -20")
+    if "error TS" in result:
+        errors = result.count("error TS")
+        print(f"  ❌ {errors}+ type errors found")
+        print(result[:500])
+    else:
+        print("  ✅ No type errors")
+
+def check_any_usage():
+    """Check for any type usage."""
+    print("\n⚠️ 'any' Type Usage:")
+    print("-" * 40)
+    
+    result = run_cmd("grep -r ': any' --include='*.ts' --include='*.tsx' src/ 2>/dev/null | wc -l")
+    count = result.strip()
+    if count and count != "0":
+        print(f"  ⚠️ Found {count} occurrences of ': any'")
+        sample = run_cmd("grep -rn ': any' --include='*.ts' --include='*.tsx' src/ 2>/dev/null | head -5")
+        if sample:
+            print(sample)
+    else:
+        print("  ✅ No explicit 'any' types found")
+
+def check_type_assertions():
+    """Check for type assertions."""
+    print("\n⚠️ Type Assertions (as):")
+    print("-" * 40)
+    
+    result = run_cmd("grep -r ' as ' --include='*.ts' --include='*.tsx' src/ 2>/dev/null | grep -v 'import' | wc -l")
+    count = result.strip()
+    if count and count != "0":
+        print(f"  ⚠️ Found {count} type assertions")
+    else:
+        print("  ✅ No type assertions found")
+
+def check_performance():
+    """Check type checking performance."""
+    print("\n⏱️ Type Check Performance:")
+    print("-" * 40)
+    
+    result = run_cmd("npx tsc --extendedDiagnostics --noEmit 2>&1 | grep -E 'Check time|Files:|Lines:|Nodes:'")
+    if result.strip():
+        for line in result.strip().split('\n'):
+            print(f"  {line}")
+    else:
+        print("  ⚠️ Could not measure performance")
+
+def main():
+    print("=" * 50)
+    print("🔍 TypeScript Project Diagnostic Report")
+    print("=" * 50)
+    
+    check_versions()
+    check_tsconfig()
+    check_tooling()
+    check_monorepo()
+    check_any_usage()
+    check_type_assertions()
+    check_type_errors()
+    check_performance()
+    
+    print("\n" + "=" * 50)
+    print("✅ Diagnostic Complete")
+    print("=" * 50)
+
+if __name__ == "__main__":
+    main()

package/docs/skill-candidates/v0.0.11/ui-component-primitives/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: ui-component-primitives
+description: "Design and implement reusable UI primitives and interaction components such as buttons, inputs, cards, modals, dropdowns, icons, toasts and navigation with accessibility and state clarity."
+---
+
+# UI Component Primitives
+
+Use this skill when the task is about reusable UI building blocks rather than page-level layout alone.
+
+## Workflow
+
+- Start from the interaction contract: trigger, focus, keyboard, dismissal and state changes.
+- Define component API, variants and states before styling details.
+- Treat modal, dropdown, popover and navigation primitives as accessibility-sensitive systems.
+- Keep icons, labels, spacing and motion consistent with the design system.
+- Validate both mouse and keyboard behavior.
+
+## Coverage
+
+- Components, primitives, modals, dropdowns, popovers, icons, buttons, forms and feedback.
+- Variants, states, accessibility, composition and design-system reuse.
+- Desktop and mobile interaction expectations.
+
+## Reference Anchors
+
+- WAI-ARIA APG: `https://www.w3.org/WAI/ARIA/apg/`
+- Material Design components: `https://m3.material.io/components`
+
+## Guardrails
+
+- Do not ship inaccessible focus, escape or keyboard behavior.
+- Do not let visual styling outrun interaction correctness.
+- Do not duplicate primitives without a strong reason.
+- Do not ignore empty, loading, disabled or error states.

package/docs/skill-candidates/v0.0.11/web-mobile-design-systems/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: web-mobile-design-systems
+description: "Shape coherent web, mobile and app-facing design systems with attention to layout, hierarchy, navigation, responsive behavior, visual language and product-level usability."
+---
+
+# Web Mobile Design Systems
+
+Use this skill when the task spans layout, visual systems and product interaction across desktop and mobile surfaces.
+
+## Workflow
+
+- Begin from information hierarchy, navigation and user goal flow.
+- Design responsive layout behavior before polishing isolated screens.
+- Keep typography, spacing, surface hierarchy and motion consistent across breakpoints.
+- Reuse patterns deliberately across web and mobile contexts while respecting platform differences.
+- Validate readability, rhythm and interaction clarity on both narrow and wide layouts.
+
+## Coverage
+
+- Layout, web design, mobile, app surfaces, UX/UI systems and responsive behavior.
+- Navigation, forms, cards, sections, density, hierarchy, motion and visual consistency.
+- Design-system framing for product teams.
+
+## Reference Anchors
+
+- Material Design 3: `https://m3.material.io/`
+- Apple Human Interface Guidelines: `https://developer.apple.com/design/human-interface-guidelines/`
+
+## Guardrails
+
+- Do not confuse visual complexity with product quality.
+- Do not force desktop structure onto mobile flows.
+- Do not treat responsiveness as a late patch.
+- Do not sacrifice clarity for novelty.

package/docs/skill-candidates/v0.0.11/windows-linux-platform-ops/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: windows-linux-platform-ops
+description: "Operate Windows and Linux developer environments with focus on filesystems, PATH, permissions, services, shells, package managers and cross-platform reliability."
+---
+
+# Windows Linux Platform Ops
+
+Use this skill when the task depends on OS-specific environment behavior across Windows or Linux.
+
+## Workflow
+
+- Identify the target OS, shell, path conventions and permission model first.
+- Treat filesystem, service, environment and package-manager differences explicitly.
+- Prefer cross-platform instructions only when they are truly equivalent.
+- Keep operator-facing paths, config locations and restart steps concrete.
+- Validate on the real platform path when possible.
+
+## Coverage
+
+- Windows and Linux paths, permissions, PATH, services, package managers and shells.
+- Config-file locations, CLI registration, restart/reload behavior and troubleshooting.
+- Cross-platform readiness for developer tooling.
+
+## Reference Anchors
+
+- Windows docs: `https://learn.microsoft.com/windows/`
+- Linux kernel docs: `https://www.kernel.org/doc/html/latest/`
+
+## Guardrails
+
+- Do not assume Linux semantics on Windows paths or permissions.
+- Do not give cross-platform instructions that are only half-true.
+- Do not omit restart/reload requirements for service or shell config changes.
+- Do not hide elevated-privilege requirements.

package/manifests/channels/beta.json

@@ -1,13 +1,13 @@
 {
   "name": "skill_master",
   "channel": "beta",
-  "version": "00.04-beta",
-  "semver": "0.0.10",
-  "publishedAt": "2026-06-28T14:00:39-03:00",
+  "version": "00.05-beta",
+  "semver": "0.0.11",
+  "publishedAt": "2026-06-28T22:16:21-03:00",
   "git": {
     "repo": "https://github.com/FPrad0/skill-master-mcp",
     "branch": "main",
-    "commit": "f955c13"
+    "commit": "569679e"
   },
   "node": {
     "minimum": "18.0.0"
@@ -19,8 +19,8 @@
     "buildCommand": "npm run build"
   },
   "changelog": [
-    "Canal beta acompanha o bundle global ampliado e a nova apresentacao cyberpunk do menu.",
-    "Fluxo interativo volta selecionavel apos executar acoes e retornar ao TUI.",
-    "Doctor, bootstrap global e registro multi-cliente continuam prontos para notebooks novos."
+    "Canal beta acompanha o bundle global v0.0.11 e o registro MCP robusto por Node absoluto.",
+    "Doctor e menu continuam auditando a matriz completa de acoes e os modos legados de configuracao.",
+    "Bootstrap global e registro multi-cliente seguem prontos para notebooks novos."
   ]
 }

package/manifests/channels/stable.json

@@ -1,13 +1,13 @@
 {
   "name": "skill_master",
   "channel": "stable",
-  "version": "00.04",
-  "semver": "0.0.10",
-  "publishedAt": "2026-06-28T14:00:39-03:00",
+  "version": "00.05",
+  "semver": "0.0.11",
+  "publishedAt": "2026-06-28T22:16:21-03:00",
   "git": {
     "repo": "https://github.com/FPrad0/skill-master-mcp",
     "branch": "main",
-    "commit": "f955c13"
+    "commit": "569679e"
   },
   "node": {
     "minimum": "18.0.0"
@@ -19,9 +19,9 @@
     "buildCommand": "npm run build"
   },
   "changelog": [
-    "Catalogo global embutido cresce com skills de frontend, backend, CLI, GitHub, OpenAI docs, design, idiomas, ciencia e MCP.",
-    "Menu visual exibe totais do bundle, dominios, metadata da acao selecionada e telemetria operacional em layout cyberpunk.",
-    "Retorno ao menu volta a aceitar selecao por teclado depois de executar uma acao.",
-    "Doctor e bootstrap continuam validando e preparando Codex, Claude, Gemini e Antigravity para uso global."
+    "Registro MCP multi-cliente agora usa Node absoluto e o entrypoint absoluto de bin/skill-master.mjs, evitando falhas de PATH em Windows, Linux, macOS e apps desktop.",
+    "Doctor passa a diferenciar registros robustos e legados, incluindo path-bin, launcher, custom, missing e invalid-json.",
+    "Menu operacional valida a matriz completa de 22 acoes e o bundle global passa a incluir o pacote ampliado de skills v0.0.11.",
+    "Bootstrap global continua instalando skills e registrando Codex, Claude, Gemini e Antigravity em um passo."
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fprad0/skill-master-mcp",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "private": false,
   "type": "module",
   "description": "Personal MCP server that catalogs, recommends and reports skills with update-aware metadata.",
@@ -25,12 +25,15 @@
     "docs/planning",
     "docs/skill-candidates",
     "docs/operations/GUIA_NPM_PRIVADO.md",
+    "docs/operations/GUIA_NPM_PUBLICO.md",
+    "docs/operations/GUIA_MULTI_COMPUTADOR.md",
     "manifests",
     "network",
     "README.md",
     "CHANGELOG.md",
     "VERSION.md",
     "examples/client-configs",
+    "scripts/verify-menu-actions.mjs",
     "scripts/configure-private-registry.mjs",
     "scripts/lib",
     "sources.json"
@@ -53,8 +56,9 @@
     "test": "vitest run",
     "setup:private-registry": "node scripts/configure-private-registry.mjs",
     "eval:activation": "npm run build && node bin/skill-master-eval-activation.mjs",
+    "verify:menu": "node scripts/verify-menu-actions.mjs",
     "check:manifest": "node scripts/check-manifest.mjs",
-    "check": "npm run build && npm test && npm run check:manifest",
+    "check": "npm run build && npm test && npm run verify:menu && npm run check:manifest",
     "prepack": "npm run build",
     "pack:dry-run": "npm pack --dry-run",
     "publish:github": "npm publish --registry=https://npm.pkg.github.com",

package/scripts/verify-menu-actions.mjs

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import {
+  buildMenuCommands,
+  resolveActionKey,
+} from '../bin/lib/menu-core.mjs';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const rootDir = dirname(here);
+const currentFile = join(rootDir, 'bin', 'skill-master-menu.mjs');
+
+const REQUIRED_ACTIONS = [
+  'status',
+  'doctor',
+  'check',
+  'build',
+  'publicNpm',
+  'updateGlobal',
+  'privateRegistry',
+  'activationStatus',
+  'activationBalanced',
+  'activationAlwaysOn',
+  'installGlobalSkills',
+  'bootstrapGlobal',
+  'registerClients',
+  'promptRecommendation',
+  'successNotifications',
+  'studySkills',
+  'approvalPackage',
+  'markLearnedStudy',
+  'rejectLearnedSkill',
+  'activateLearnedLocal',
+  'activateLearnedGlobal',
+  'notionSummary',
+];
+
+const CONFIRMATION_REQUIRED = [
+  'updateGlobal',
+  'privateRegistry',
+  'activationAlwaysOn',
+  'installGlobalSkills',
+  'bootstrapGlobal',
+  'registerClients',
+  'rejectLearnedSkill',
+  'activateLearnedLocal',
+  'activateLearnedGlobal',
+];
+
+const READ_ONLY_ACTIONS = [
+  'status',
+  'doctor',
+  'publicNpm',
+  'activationStatus',
+  'successNotifications',
+  'studySkills',
+  'approvalPackage',
+  'notionSummary',
+];
+
+const commands = buildMenuCommands({
+  rootDir,
+  currentFile,
+  nodeExecPath: process.execPath,
+});
+
+const byKey = new Map(commands.map((command) => [command.key, command]));
+const failures = [];
+
+for (const key of REQUIRED_ACTIONS) {
+  if (!byKey.has(key)) failures.push(`missing action: ${key}`);
+}
+
+for (const key of CONFIRMATION_REQUIRED) {
+  const command = byKey.get(key);
+  if (command && !command.confirmMessage) failures.push(`missing confirmation: ${key}`);
+}
+
+for (const command of commands) {
+  if (!command.command) failures.push(`missing command executable: ${command.key}`);
+  if (!Array.isArray(command.args)) failures.push(`args must be array: ${command.key}`);
+  for (const alias of command.aliases ?? []) {
+    if (resolveActionKey(alias, commands) !== command.key) failures.push(`alias does not resolve: ${command.key}:${alias}`);
+  }
+}
+
+for (const key of READ_ONLY_ACTIONS) {
+  const command = byKey.get(key);
+  if (!command) continue;
+  if (command.confirmMessage) failures.push(`read-only action unexpectedly asks confirmation: ${key}`);
+}
+
+console.log('Skill Master menu action verification');
+console.log(`- Actions: ${commands.length}`);
+console.log(`- Required actions: ${REQUIRED_ACTIONS.length}`);
+console.log(`- Read-only smoke candidates: ${READ_ONLY_ACTIONS.join(', ')}`);
+console.log(`- Confirmation protected: ${CONFIRMATION_REQUIRED.join(', ')}`);
+console.log('');
+
+for (const command of commands) {
+  const protection = command.confirmMessage ? 'confirm' : 'direct';
+  const disabled = command.disabledReason ? 'disabled' : 'enabled';
+  console.log(`- ${command.key}: ${disabled}, ${protection}, aliases=${command.aliases.join('|') || '-'}`);
+}
+
+if (failures.length) {
+  console.log('');
+  console.log('Failures:');
+  for (const failure of failures) console.log(`- ${failure}`);
+  process.exitCode = 1;
+} else {
+  console.log('');
+  console.log('Menu action matrix OK.');
+}