@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
  1. package/CHANGELOG.md +96 -90
  2. package/README.md +472 -472
  3. package/VERSION.md +9 -9
  4. package/bin/lib/bootstrap-global-core.mjs +34 -0
  5. package/bin/lib/client-config.mjs +293 -293
  6. package/bin/lib/doctor-core.mjs +202 -0
  7. package/bin/lib/menu-core.mjs +1629 -1522
  8. package/bin/lib/operation-result.mjs +59 -0
  9. package/bin/lib/register-clients-core.mjs +247 -0
  10. package/bin/lib/skill-installation.mjs +215 -215
  11. package/bin/lib/update-cli-core.mjs +117 -0
  12. package/bin/skill-master-activation.mjs +163 -163
  13. package/bin/skill-master-bootstrap-global.mjs +61 -49
  14. package/bin/skill-master-configure-private-registry.mjs +3 -3
  15. package/bin/skill-master-doctor.mjs +239 -228
  16. package/bin/skill-master-eval-activation.mjs +32 -32
  17. package/bin/skill-master-install-global-skills.mjs +59 -59
  18. package/bin/skill-master-install-project-skills.mjs +97 -97
  19. package/bin/skill-master-menu.mjs +406 -405
  20. package/bin/skill-master-register-clients.mjs +232 -153
  21. package/bin/skill-master-success-skills.mjs +307 -307
  22. package/bin/skill-master-update.mjs +121 -72
  23. package/bin/skill-master.mjs +3 -3
  24. package/dist/activation.d.ts.map +1 -1
  25. package/dist/activation.js +12 -0
  26. package/dist/activation.js.map +1 -1
  27. package/dist/prompt-router.d.ts.map +1 -1
  28. package/dist/prompt-router.js +19 -0
  29. package/dist/prompt-router.js.map +1 -1
  30. package/dist/recommender.d.ts.map +1 -1
  31. package/dist/recommender.js +4 -1
  32. package/dist/recommender.js.map +1 -1
  33. package/docs/architecture/APRENDIZADO_DE_IMPLEMENTACOES_BEM_SUCEDIDAS.md +125 -125
  34. package/docs/architecture/ARQUITETURA_AUTO_UPDATE.md +9 -9
  35. package/docs/architecture/PLANO_MASTER_ACIONAMENTO_AUTOMATICO_E_APRENDIZADO.md +341 -341
  36. package/docs/architecture/REDE_SEGURA_DE_SKILLS.md +148 -148
  37. package/docs/operations/GUIA_MULTI_COMPUTADOR.md +262 -262
  38. package/docs/operations/GUIA_NPM_PRIVADO.md +294 -294
  39. package/docs/operations/GUIA_NPM_PUBLICO.md +147 -147
  40. package/docs/operations/MENU_VISUAL_EVIDENCE_2026-06-28.md +66 -66
  41. package/docs/operations/assets/menu-frame-compact.html +75 -75
  42. package/docs/operations/assets/menu-frame-large.html +83 -83
  43. package/docs/operations/assets/menu-frame-running.html +79 -79
  44. package/docs/operations/cross-platform-auth-transfer/ANALISE_COMPATIBILIDADE_MCP_2026-06-28.md +140 -140
  45. package/docs/operations/cross-platform-auth-transfer/README_TRANSFERENCIA.md +85 -85
  46. package/docs/operations/reborn-menu-cyberpunk-transfer/ANALISE_MENU_REBORN_CYBERPUNK_2026-06-28.md +174 -174
  47. package/docs/operations/reborn-menu-cyberpunk-transfer/HANDOFF_IMPLEMENTACAO_REBORN_CYBERPUNK_2026-06-28.md +119 -119
  48. package/docs/operations/reborn-menu-cyberpunk-transfer/ORDEM_DE_EXECUCAO_MENU_REBORN_CYBERPUNK.md +134 -134
  49. package/docs/operations/reborn-menu-cyberpunk-transfer/README_TRANSFERENCIA.md +84 -84
  50. package/docs/operations/reborn-menu-cyberpunk-transfer/README_TRANSFERENCIA_REBORN_PACKAGE.md +56 -56
  51. package/docs/operations/token-economy-transfer/ANALISE_AVANCADA_ECONOMIA_TOKENS_2026-06-30.md +141 -0
  52. package/docs/operations/token-economy-transfer/PLANO_DEV_SENIOR_MASTER_TOKEN_ECONOMY_2026-06-30.md +171 -0
  53. package/docs/operations/token-economy-transfer/README_TRANSFERENCIA_TOKEN_ECONOMY.md +31 -0
  54. package/docs/planning/MENU_RUNTIME_CORRECTION_PLAN_2026-06-30.md +551 -0
  55. package/docs/planning/V0_0_9_APROVACAO_CRITICA_MENSAGENS_DE_VENDA.md +85 -85
  56. package/docs/planning/V0_0_9_FONTES_E_CRITERIOS_DE_AUTORIDADE.md +139 -139
  57. package/docs/planning/V0_0_9_MATRIZ_SKILLS_MULTIDISCIPLINARES.md +105 -105
  58. package/docs/planning/V0_0_9_POLITICA_MORAL_CATOLICA_PARA_IA.md +181 -181
  59. package/docs/planning/V0_0_9_PROMPTS_EXECUCAO.md +59 -59
  60. package/docs/planning/V0_0_9_ROADMAP_DISCERNIMENTO_E_CONHECIMENTO_AMPLO.md +181 -181
  61. package/docs/prompt-tasks/PROMPT_TASK_001_BOOTSTRAP_SKILL_MASTER_MCP.md +6 -6
  62. package/docs/prompt-tasks/PROMPT_TASK_002_AUTO_UPDATE_LAUNCHER.md +6 -6
  63. package/docs/prompt-tasks/PROMPT_TASK_003_REMOTE_MANIFEST_AND_RELEASES.md +6 -6
  64. package/docs/prompt-tasks/PROMPT_TASK_004_MULTI_USER_DISTRIBUTION.md +6 -6
  65. package/docs/prompt-tasks/PROMPT_TASK_005_SECURITY_AND_QUALITY_GATE.md +6 -6
  66. package/docs/prompt-tasks/PROMPT_TASK_006_MASTER_ACIONAMENTO_APRENDIZADO.md +83 -83
  67. package/docs/prompt-tasks/PROMPT_TASK_007_PERSONA_ORQUESTRADORA.md +88 -88
  68. package/docs/prompt-tasks/PROMPT_TASK_008_PROMPT_ROUTER_MODOS_ATIVACAO.md +156 -156
  69. package/docs/prompt-tasks/PROMPT_TASK_009_PIPELINE_APRENDIZADO_SUCESSO.md +105 -105
  70. package/docs/prompt-tasks/PROMPT_TASK_010_EVALS_GOVERNANCA_ATIVACAO.md +119 -119
  71. package/docs/prompt-tasks/PROMPT_TASK_011_MENU_NOTIFICACOES_NOTION.md +120 -120
  72. package/docs/prompt-tasks/PROMPT_TASK_012_MENU_CYBERPUNK_PIXEL_FRAME.md +123 -123
  73. package/docs/prompt-tasks/PROMPT_TASK_013_MENU_FLUID_DNA_ANIMATION.md +114 -114
  74. package/docs/prompt-tasks/PROMPT_TASK_014_MENU_FUNCTIONAL_PARITY_QA.md +157 -157
  75. package/docs/prompt-tasks/PROMPT_TASK_015_TRANSFER_RELEASE_HANDOFF.md +127 -127
  76. package/docs/prompt-tasks/PROMPT_TASK_016_CROSS_PLATFORM_MCP_AUTH_REGISTRATION.md +107 -107
  77. package/docs/prompt-tasks/PROMPT_TASK_018_NPM_PUBLISH_2FA_SETUP.md +80 -80
  78. package/docs/prompt-tasks/PROMPT_TASK_019_TOKEN_ECONOMY_GLOBAL_SKILLS.md +56 -0
  79. package/docs/prompt-tasks/PROMPT_TASK_MASTER_EXECUTOR.md +6 -6
  80. package/docs/skill-candidates/v0.0.10/cli-creator/LICENSE.txt +201 -201
  81. package/docs/skill-candidates/v0.0.10/cli-creator/SKILL.md +160 -160
  82. package/docs/skill-candidates/v0.0.10/cli-creator/agents/openai.yaml +4 -4
  83. package/docs/skill-candidates/v0.0.10/cli-creator/references/agent-cli-patterns.md +154 -154
  84. package/docs/skill-candidates/v0.0.10/developer-workstation-ops/SKILL.md +32 -32
  85. package/docs/skill-candidates/v0.0.10/figma/LICENSE.txt +1 -1
  86. package/docs/skill-candidates/v0.0.10/figma/SKILL.md +42 -42
  87. package/docs/skill-candidates/v0.0.10/figma/agents/openai.yaml +14 -14
  88. package/docs/skill-candidates/v0.0.10/figma/assets/figma-small.svg +3 -3
  89. package/docs/skill-candidates/v0.0.10/figma/assets/icon.svg +28 -28
  90. package/docs/skill-candidates/v0.0.10/figma/references/figma-mcp-config.md +35 -35
  91. package/docs/skill-candidates/v0.0.10/figma/references/figma-tools-and-prompts.md +34 -34
  92. package/docs/skill-candidates/v0.0.10/figma-code-connect-components/LICENSE.TXT +1 -1
  93. package/docs/skill-candidates/v0.0.10/figma-code-connect-components/SKILL.md +349 -349
  94. package/docs/skill-candidates/v0.0.10/figma-code-connect-components/agents/openai.yaml +14 -14
  95. package/docs/skill-candidates/v0.0.10/figma-code-connect-components/assets/figma-small.svg +3 -3
  96. package/docs/skill-candidates/v0.0.10/figma-code-connect-components/assets/icon.svg +28 -28
  97. package/docs/skill-candidates/v0.0.10/figma-code-connect-components/references/mapping-checklist.md +7 -7
  98. package/docs/skill-candidates/v0.0.10/figma-code-connect-components/scripts/normalize_node_id.py +25 -25
  99. package/docs/skill-candidates/v0.0.10/figma-create-design-system-rules/LICENSE.TXT +1 -1
  100. package/docs/skill-candidates/v0.0.10/figma-create-design-system-rules/SKILL.md +537 -537
  101. package/docs/skill-candidates/v0.0.10/figma-create-design-system-rules/agents/openai.yaml +14 -14
  102. package/docs/skill-candidates/v0.0.10/figma-create-design-system-rules/assets/figma-small.svg +3 -3
  103. package/docs/skill-candidates/v0.0.10/figma-create-design-system-rules/assets/icon.svg +28 -28
  104. package/docs/skill-candidates/v0.0.10/figma-create-design-system-rules/references/rule-template.md +15 -15
  105. package/docs/skill-candidates/v0.0.10/figma-create-design-system-rules/scripts/check_agents_md.sh +9 -9
  106. package/docs/skill-candidates/v0.0.10/figma-generate-design/LICENSE.TXT +1 -1
  107. package/docs/skill-candidates/v0.0.10/figma-generate-design/SKILL.md +341 -341
  108. package/docs/skill-candidates/v0.0.10/figma-generate-design/agents/openai.yaml +14 -14
  109. package/docs/skill-candidates/v0.0.10/figma-generate-design/assets/figma-small.svg +3 -3
  110. package/docs/skill-candidates/v0.0.10/figma-generate-design/assets/icon.svg +28 -28
  111. package/docs/skill-candidates/v0.0.10/figma-generate-design/maintainers.yml +1 -1
  112. package/docs/skill-candidates/v0.0.10/figma-generate-library/LICENSE.TXT +1 -1
  113. package/docs/skill-candidates/v0.0.10/figma-generate-library/SKILL.md +314 -314
  114. package/docs/skill-candidates/v0.0.10/figma-generate-library/agents/openai.yaml +14 -14
  115. package/docs/skill-candidates/v0.0.10/figma-generate-library/assets/figma-small.svg +3 -3
  116. package/docs/skill-candidates/v0.0.10/figma-generate-library/assets/icon.svg +28 -28
  117. package/docs/skill-candidates/v0.0.10/figma-generate-library/maintainers.yml +3 -3
  118. package/docs/skill-candidates/v0.0.10/figma-generate-library/references/code-connect-setup.md +260 -260
  119. package/docs/skill-candidates/v0.0.10/figma-generate-library/references/component-creation.md +1014 -1014
  120. package/docs/skill-candidates/v0.0.10/figma-generate-library/references/discovery-phase.md +518 -518
  121. package/docs/skill-candidates/v0.0.10/figma-generate-library/references/documentation-creation.md +834 -834
  122. package/docs/skill-candidates/v0.0.10/figma-generate-library/references/error-recovery.md +540 -540
  123. package/docs/skill-candidates/v0.0.10/figma-generate-library/references/naming-conventions.md +527 -527
  124. package/docs/skill-candidates/v0.0.10/figma-generate-library/references/token-creation.md +962 -962
  125. package/docs/skill-candidates/v0.0.10/figma-generate-library/scripts/bindVariablesToComponent.js +110 -110
  126. package/docs/skill-candidates/v0.0.10/figma-generate-library/scripts/cleanupOrphans.js +127 -127
  127. package/docs/skill-candidates/v0.0.10/figma-generate-library/scripts/createComponentWithVariants.js +148 -148
  128. package/docs/skill-candidates/v0.0.10/figma-generate-library/scripts/createDocumentationPage.js +139 -139
  129. package/docs/skill-candidates/v0.0.10/figma-generate-library/scripts/createSemanticTokens.js +108 -108
  130. package/docs/skill-candidates/v0.0.10/figma-generate-library/scripts/createVariableCollection.js +49 -49
  131. package/docs/skill-candidates/v0.0.10/figma-generate-library/scripts/inspectFileStructure.js +121 -121
  132. package/docs/skill-candidates/v0.0.10/figma-generate-library/scripts/rehydrateState.js +92 -92
  133. package/docs/skill-candidates/v0.0.10/figma-generate-library/scripts/validateCreation.js +83 -83
  134. package/docs/skill-candidates/v0.0.10/figma-implement-design/LICENSE.txt +1 -1
  135. package/docs/skill-candidates/v0.0.10/figma-implement-design/SKILL.md +258 -258
  136. package/docs/skill-candidates/v0.0.10/figma-implement-design/agents/openai.yaml +14 -14
  137. package/docs/skill-candidates/v0.0.10/figma-implement-design/assets/figma-small.svg +3 -3
  138. package/docs/skill-candidates/v0.0.10/figma-implement-design/assets/icon.svg +28 -28
  139. package/docs/skill-candidates/v0.0.10/figma-use/LICENSE.TXT +1 -1
  140. package/docs/skill-candidates/v0.0.10/figma-use/SKILL.md +233 -233
  141. package/docs/skill-candidates/v0.0.10/figma-use/agents/openai.yaml +14 -14
  142. package/docs/skill-candidates/v0.0.10/figma-use/assets/figma-small.svg +3 -3
  143. package/docs/skill-candidates/v0.0.10/figma-use/assets/icon.svg +28 -28
  144. package/docs/skill-candidates/v0.0.10/figma-use/maintainers.yml +1 -1
  145. package/docs/skill-candidates/v0.0.10/figma-use/references/api-reference.md +301 -301
  146. package/docs/skill-candidates/v0.0.10/figma-use/references/common-patterns.md +512 -512
  147. package/docs/skill-candidates/v0.0.10/figma-use/references/component-patterns.md +488 -488
  148. package/docs/skill-candidates/v0.0.10/figma-use/references/effect-style-patterns.md +123 -123
  149. package/docs/skill-candidates/v0.0.10/figma-use/references/gotchas.md +599 -599
  150. package/docs/skill-candidates/v0.0.10/figma-use/references/maintainers.yml +12 -12
  151. package/docs/skill-candidates/v0.0.10/figma-use/references/plugin-api-patterns.md +513 -513
  152. package/docs/skill-candidates/v0.0.10/figma-use/references/plugin-api-standalone.d.ts +11293 -11293
  153. package/docs/skill-candidates/v0.0.10/figma-use/references/plugin-api-standalone.index.md +441 -441
  154. package/docs/skill-candidates/v0.0.10/figma-use/references/text-style-patterns.md +203 -203
  155. package/docs/skill-candidates/v0.0.10/figma-use/references/validation-and-recovery.md +109 -109
  156. package/docs/skill-candidates/v0.0.10/figma-use/references/variable-patterns.md +354 -354
  157. package/docs/skill-candidates/v0.0.10/figma-use/references/working-with-design-systems/maintainers.yml +9 -9
  158. package/docs/skill-candidates/v0.0.10/figma-use/references/working-with-design-systems/wwds-components--creating.md +17 -17
  159. package/docs/skill-candidates/v0.0.10/figma-use/references/working-with-design-systems/wwds-components--using.md +17 -17
  160. package/docs/skill-candidates/v0.0.10/figma-use/references/working-with-design-systems/wwds-components.md +50 -50
  161. package/docs/skill-candidates/v0.0.10/figma-use/references/working-with-design-systems/wwds-effect-styles.md +52 -52
  162. package/docs/skill-candidates/v0.0.10/figma-use/references/working-with-design-systems/wwds-text-styles.md +90 -90
  163. package/docs/skill-candidates/v0.0.10/figma-use/references/working-with-design-systems/wwds-variables--creating.md +13 -13
  164. package/docs/skill-candidates/v0.0.10/figma-use/references/working-with-design-systems/wwds-variables--using.md +13 -13
  165. package/docs/skill-candidates/v0.0.10/figma-use/references/working-with-design-systems/wwds-variables.md +64 -64
  166. package/docs/skill-candidates/v0.0.10/figma-use/references/working-with-design-systems/wwds.md +41 -41
  167. package/docs/skill-candidates/v0.0.10/frontend-design/LICENSE.txt +177 -177
  168. package/docs/skill-candidates/v0.0.10/frontend-design/SKILL.md +55 -55
  169. package/docs/skill-candidates/v0.0.10/frontend-ui-ux-systems/SKILL.md +32 -32
  170. package/docs/skill-candidates/v0.0.10/github/SKILL.md +74 -74
  171. package/docs/skill-candidates/v0.0.10/github/agents/openai.yaml +6 -6
  172. package/docs/skill-candidates/v0.0.10/github/assets/github-small.svg +3 -3
  173. package/docs/skill-candidates/v0.0.10/image-graphic-design-rendering/SKILL.md +28 -28
  174. package/docs/skill-candidates/v0.0.10/language-quality-pt-en-fr-it-ru/SKILL.md +28 -28
  175. package/docs/skill-candidates/v0.0.10/math-physics-reasoning/SKILL.md +28 -28
  176. package/docs/skill-candidates/v0.0.10/mcp-builder/LICENSE.txt +201 -201
  177. package/docs/skill-candidates/v0.0.10/mcp-builder/SKILL.md +236 -236
  178. package/docs/skill-candidates/v0.0.10/mcp-builder/reference/evaluation.md +601 -601
  179. package/docs/skill-candidates/v0.0.10/mcp-builder/reference/mcp_best_practices.md +249 -249
  180. package/docs/skill-candidates/v0.0.10/mcp-builder/reference/node_mcp_server.md +969 -969
  181. package/docs/skill-candidates/v0.0.10/mcp-builder/reference/python_mcp_server.md +718 -718
  182. package/docs/skill-candidates/v0.0.10/mcp-builder/scripts/connections.py +151 -151
  183. package/docs/skill-candidates/v0.0.10/mcp-builder/scripts/evaluation.py +373 -373
  184. package/docs/skill-candidates/v0.0.10/mcp-builder/scripts/example_evaluation.xml +22 -22
  185. package/docs/skill-candidates/v0.0.10/mcp-builder/scripts/requirements.txt +2 -2
  186. package/docs/skill-candidates/v0.0.10/mcp-client-readiness/SKILL.md +31 -31
  187. package/docs/skill-candidates/v0.0.10/openai-docs/LICENSE.txt +201 -201
  188. package/docs/skill-candidates/v0.0.10/openai-docs/SKILL.md +161 -161
  189. package/docs/skill-candidates/v0.0.10/openai-docs/agents/openai.yaml +14 -14
  190. package/docs/skill-candidates/v0.0.10/openai-docs/assets/openai-small.svg +3 -3
  191. package/docs/skill-candidates/v0.0.10/openai-docs/references/latest-model.md +37 -37
  192. package/docs/skill-candidates/v0.0.10/openai-docs/references/prompting-guide.md +244 -244
  193. package/docs/skill-candidates/v0.0.10/openai-docs/references/upgrade-guide.md +181 -181
  194. package/docs/skill-candidates/v0.0.10/openai-docs/scripts/fetch-codex-manual.mjs +598 -598
  195. package/docs/skill-candidates/v0.0.10/openai-docs/scripts/resolve-latest-model-info.js +147 -147
  196. package/docs/skill-candidates/v0.0.10/playwright/NOTICE.txt +14 -14
  197. package/docs/skill-candidates/v0.0.10/playwright/SKILL.md +147 -147
  198. package/docs/skill-candidates/v0.0.10/playwright/agents/openai.yaml +6 -6
  199. package/docs/skill-candidates/v0.0.10/playwright/assets/playwright-small.svg +3 -3
  200. package/docs/skill-candidates/v0.0.10/playwright/references/cli.md +116 -116
  201. package/docs/skill-candidates/v0.0.10/playwright/references/workflows.md +95 -95
  202. package/docs/skill-candidates/v0.0.10/playwright/scripts/playwright_cli.sh +25 -25
  203. package/docs/skill-candidates/v0.0.10/polyglot-backend-engineering/SKILL.md +32 -32
  204. package/docs/skill-candidates/v0.0.10/screenshot/LICENSE.txt +201 -201
  205. package/docs/skill-candidates/v0.0.10/screenshot/SKILL.md +267 -267
  206. package/docs/skill-candidates/v0.0.10/screenshot/agents/openai.yaml +6 -6
  207. package/docs/skill-candidates/v0.0.10/screenshot/assets/screenshot-small.svg +5 -5
  208. package/docs/skill-candidates/v0.0.10/screenshot/scripts/ensure_macos_permissions.sh +54 -54
  209. package/docs/skill-candidates/v0.0.10/screenshot/scripts/macos_display_info.swift +22 -22
  210. package/docs/skill-candidates/v0.0.10/screenshot/scripts/macos_permissions.swift +40 -40
  211. package/docs/skill-candidates/v0.0.10/screenshot/scripts/macos_window_info.swift +126 -126
  212. package/docs/skill-candidates/v0.0.10/screenshot/scripts/take_screenshot.ps1 +163 -163
  213. package/docs/skill-candidates/v0.0.10/screenshot/scripts/take_screenshot.py +585 -585
  214. package/docs/skill-candidates/v0.0.10/skill-master-orchestrator/SKILL.md +62 -62
  215. package/docs/skill-candidates/v0.0.10/skill-master-orchestrator/agents/openai.yaml +4 -4
  216. package/docs/skill-candidates/v0.0.10/skill-master-orchestrator/references/activation-policy.md +77 -77
  217. package/docs/skill-candidates/v0.0.10/skill-master-orchestrator/references/human-approval-policy.md +83 -83
  218. package/docs/skill-candidates/v0.0.10/skill-master-orchestrator/references/persona-dev-senior-master.md +46 -46
  219. package/docs/skill-candidates/v0.0.10/terminal-menu-operations/SKILL.md +30 -30
  220. package/docs/skill-candidates/v0.0.10/terminal-pixel-art-tui/SKILL.md +43 -43
  221. package/docs/skill-candidates/v0.0.10/webapp-testing/LICENSE.txt +201 -201
  222. package/docs/skill-candidates/v0.0.10/webapp-testing/SKILL.md +95 -95
  223. package/docs/skill-candidates/v0.0.10/webapp-testing/examples/console_logging.py +34 -34
  224. package/docs/skill-candidates/v0.0.10/webapp-testing/examples/element_discovery.py +39 -39
  225. package/docs/skill-candidates/v0.0.10/webapp-testing/examples/static_html_automation.py +32 -32
  226. package/docs/skill-candidates/v0.0.10/webapp-testing/scripts/with_server.py +105 -105
  227. package/docs/skill-candidates/v0.0.10/winui-app/LICENSE.txt +201 -201
  228. package/docs/skill-candidates/v0.0.10/winui-app/SKILL.md +94 -94
  229. package/docs/skill-candidates/v0.0.10/winui-app/agents/openai.yaml +5 -5
  230. package/docs/skill-candidates/v0.0.10/winui-app/config.yaml +50 -50
  231. package/docs/skill-candidates/v0.0.10/winui-app/references/_sections.md +96 -96
  232. package/docs/skill-candidates/v0.0.10/winui-app/references/accessibility-input-and-localization.md +51 -51
  233. package/docs/skill-candidates/v0.0.10/winui-app/references/build-run-and-launch-verification.md +72 -72
  234. package/docs/skill-candidates/v0.0.10/winui-app/references/community-toolkit-controls-and-helpers.md +57 -57
  235. package/docs/skill-candidates/v0.0.10/winui-app/references/controls-layout-and-adaptive-ui.md +84 -84
  236. package/docs/skill-candidates/v0.0.10/winui-app/references/foundation-environment-audit-and-remediation.md +82 -82
  237. package/docs/skill-candidates/v0.0.10/winui-app/references/foundation-setup-and-project-selection.md +67 -67
  238. package/docs/skill-candidates/v0.0.10/winui-app/references/foundation-template-first-recovery.md +62 -62
  239. package/docs/skill-candidates/v0.0.10/winui-app/references/foundation-winui-app-structure.md +62 -62
  240. package/docs/skill-candidates/v0.0.10/winui-app/references/motion-animations-and-polish.md +45 -45
  241. package/docs/skill-candidates/v0.0.10/winui-app/references/performance-diagnostics-and-responsiveness.md +46 -46
  242. package/docs/skill-candidates/v0.0.10/winui-app/references/sample-source-map.md +37 -37
  243. package/docs/skill-candidates/v0.0.10/winui-app/references/shell-navigation-and-windowing.md +67 -67
  244. package/docs/skill-candidates/v0.0.10/winui-app/references/styling-theming-materials-and-icons.md +71 -71
  245. package/docs/skill-candidates/v0.0.10/winui-app/references/testing-debugging-and-review-checklists.md +77 -77
  246. package/docs/skill-candidates/v0.0.10/winui-app/references/windows-app-sdk-lifecycle-notifications-and-deployment.md +52 -52
  247. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/SKILL.md +398 -398
  248. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/resources/common-patterns.md +330 -330
  249. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/resources/complete-examples.md +871 -871
  250. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/resources/component-patterns.md +501 -501
  251. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/resources/data-fetching.md +766 -766
  252. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/resources/file-organization.md +501 -501
  253. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/resources/loading-and-error-states.md +500 -500
  254. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/resources/performance.md +405 -405
  255. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/resources/routing-guide.md +363 -363
  256. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/resources/styling-guide.md +427 -427
  257. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/resources/typescript-standards.md +417 -417
  258. package/docs/skill-candidates/v0.0.11/git-version-control-ops/SKILL.md +34 -34
  259. package/docs/skill-candidates/v0.0.11/go-engineering/SKILL.md +34 -34
  260. package/docs/skill-candidates/v0.0.11/java-engineering/SKILL.md +34 -34
  261. package/docs/skill-candidates/v0.0.11/javascript-engineering/SKILL.md +34 -34
  262. package/docs/skill-candidates/v0.0.11/json-contract-design/SKILL.md +34 -34
  263. package/docs/skill-candidates/v0.0.11/multi-client-mcp-ops/SKILL.md +36 -36
  264. package/docs/skill-candidates/v0.0.11/nextjs/SKILL.md +745 -745
  265. package/docs/skill-candidates/v0.0.11/nextjs/agents/openai.yaml +3 -3
  266. package/docs/skill-candidates/v0.0.11/nextjs/references/app-router-files.md +94 -94
  267. package/docs/skill-candidates/v0.0.11/python-engineering/SKILL.md +34 -34
  268. package/docs/skill-candidates/v0.0.11/ruby-engineering/SKILL.md +34 -34
  269. package/docs/skill-candidates/v0.0.11/senior-fullstack/SKILL.md +209 -209
  270. package/docs/skill-candidates/v0.0.11/senior-fullstack/references/architecture_patterns.md +103 -103
  271. package/docs/skill-candidates/v0.0.11/senior-fullstack/references/development_workflows.md +103 -103
  272. package/docs/skill-candidates/v0.0.11/senior-fullstack/references/tech_stack_guide.md +103 -103
  273. package/docs/skill-candidates/v0.0.11/senior-fullstack/scripts/code_quality_analyzer.py +114 -114
  274. package/docs/skill-candidates/v0.0.11/senior-fullstack/scripts/fullstack_scaffolder.py +114 -114
  275. package/docs/skill-candidates/v0.0.11/senior-fullstack/scripts/project_scaffolder.py +114 -114
  276. package/docs/skill-candidates/v0.0.11/shadcn/SKILL.md +573 -573
  277. package/docs/skill-candidates/v0.0.11/shadcn/agents/openai.yaml +3 -3
  278. package/docs/skill-candidates/v0.0.11/sql-postgresql-engineering/SKILL.md +34 -34
  279. package/docs/skill-candidates/v0.0.11/terminal-shell-ops/SKILL.md +34 -34
  280. package/docs/skill-candidates/v0.0.11/typescript-expert/SKILL.md +429 -429
  281. package/docs/skill-candidates/v0.0.11/typescript-expert/references/tsconfig-strict.json +91 -91
  282. package/docs/skill-candidates/v0.0.11/typescript-expert/references/typescript-cheatsheet.md +383 -383
  283. package/docs/skill-candidates/v0.0.11/typescript-expert/references/utility-types.ts +335 -335
  284. package/docs/skill-candidates/v0.0.11/typescript-expert/scripts/ts_diagnostic.py +203 -203
  285. package/docs/skill-candidates/v0.0.11/ui-component-primitives/SKILL.md +34 -34
  286. package/docs/skill-candidates/v0.0.11/web-mobile-design-systems/SKILL.md +34 -34
  287. package/docs/skill-candidates/v0.0.11/windows-linux-platform-ops/SKILL.md +34 -34
  288. package/docs/skill-candidates/v0.0.12/context-compression-handoff/SKILL.md +47 -0
  289. package/docs/skill-candidates/v0.0.12/csharp-senior-master-engineering/SKILL.md +32 -32
  290. package/docs/skill-candidates/v0.0.12/css-senior-master-engineering/SKILL.md +32 -32
  291. package/docs/skill-candidates/v0.0.12/go-senior-master-engineering/SKILL.md +32 -32
  292. package/docs/skill-candidates/v0.0.12/html-senior-master-engineering/SKILL.md +32 -32
  293. package/docs/skill-candidates/v0.0.12/javascript-senior-master-engineering/SKILL.md +32 -32
  294. package/docs/skill-candidates/v0.0.12/json-senior-master-engineering/SKILL.md +32 -32
  295. package/docs/skill-candidates/v0.0.12/prompt-budget-gate/SKILL.md +46 -0
  296. package/docs/skill-candidates/v0.0.12/python-senior-master-engineering/SKILL.md +32 -32
  297. package/docs/skill-candidates/v0.0.12/react-senior-master-engineering/SKILL.md +32 -32
  298. package/docs/skill-candidates/v0.0.12/ruby-senior-master-engineering/SKILL.md +32 -32
  299. package/docs/skill-candidates/v0.0.12/senior-master-code-optimizer/SKILL.md +48 -48
  300. package/docs/skill-candidates/v0.0.12/sql-senior-master-engineering/SKILL.md +31 -31
  301. package/docs/skill-candidates/v0.0.12/token-economy-orchestrator/SKILL.md +38 -0
  302. package/docs/skill-candidates/v0.0.12/typescript-senior-master-engineering/SKILL.md +35 -35
  303. package/docs/skill-candidates/v0.0.9/ai-ethics-human-dignity/SKILL.md +32 -32
  304. package/docs/skill-candidates/v0.0.9/broad-domain-router/SKILL.md +41 -41
  305. package/docs/skill-candidates/v0.0.9/catholic-moral-discernment/SKILL.md +31 -31
  306. package/docs/skill-candidates/v0.0.9/engineering-systems-master/SKILL.md +31 -31
  307. package/docs/skill-candidates/v0.0.9/language-quality-pt-en-fr/SKILL.md +28 -28
  308. package/docs/skill-candidates/v0.0.9/math-science-reasoning/SKILL.md +29 -29
  309. package/docs/skill-candidates/v0.0.9/philosophy-sociology-discernment/SKILL.md +28 -28
  310. package/docs/skill-candidates/v0.0.9/professional-boundary-triage/SKILL.md +40 -40
  311. package/docs/skill-candidates/v0.0.9/release-ethics-gate/SKILL.md +32 -32
  312. package/docs/skill-candidates/v0.0.9/source-authority-reviewer/SKILL.md +31 -31
  313. package/examples/client-configs/claude-code.commands.md +21 -21
  314. package/examples/client-configs/claude-code.project.mcp.json +18 -18
  315. package/examples/client-configs/claude-desktop.macos.json +18 -18
  316. package/examples/client-configs/claude-desktop.windows.json +20 -20
  317. package/examples/client-configs/codex.windows.toml +11 -11
  318. package/examples/client-configs/gemini-code-assist.intellij.mcp.json +18 -18
  319. package/examples/client-configs/gemini.linux.settings.json +21 -21
  320. package/examples/client-configs/gemini.windows.settings.json +23 -23
  321. package/examples/client-configs/generic-stdio.json +16 -16
  322. package/manifests/channels/beta.json +26 -26
  323. package/manifests/channels/stable.json +27 -27
  324. package/network/approved-skills.json +54 -54
  325. package/network/unapproved-skill-candidates.json +110 -110
  326. package/package.json +87 -86
  327. package/scripts/configure-private-registry.mjs +208 -208
  328. package/scripts/lib/private-registry.mjs +97 -97
  329. package/scripts/render-menu-evidence.mjs +130 -130
  330. package/scripts/verify-menu-actions.mjs +117 -117
  331. package/sources.json +11 -11
@@ -1,405 +1,406 @@
1
- #!/usr/bin/env node
2
-
3
- import prompts from 'prompts';
4
- import readline from 'node:readline';
5
- import { dirname } from 'node:path';
6
- import { fileURLToPath } from 'node:url';
7
- import {
8
- buildMenuCommands,
9
- formatActionHeader,
10
- formatCyberConfirmFrame,
11
- formatCyberMenuFrame,
12
- formatHelp,
13
- formatRunningActionFrame,
14
- formatResultMessage,
15
- formatSkillMasterIntroFrame,
16
- formatStatusReport,
17
- getMenuStatus,
18
- isInteractiveTerminal,
19
- resolveActionKey,
20
- runCommand,
21
- } from './lib/menu-core.mjs';
22
-
23
- const currentFile = fileURLToPath(import.meta.url);
24
- const rootDir = dirname(dirname(currentFile));
25
- const invocationCwd = process.cwd();
26
- const commands = buildMenuCommands({ rootDir, currentFile, invocationCwd });
27
- readline.emitKeypressEvents(process.stdin);
28
- const CONTROL = {
29
- alternateScreenIn: '\x1b[?1049h',
30
- alternateScreenOut: '\x1b[?1049l',
31
- hideCursor: '\x1b[?25l',
32
- showCursor: '\x1b[?25h',
33
- cursorHome: '\x1b[H',
34
- clearScreen: '\x1b[2J',
35
- clearToEnd: '\x1b[0J',
36
- reset: '\x1b[0m',
37
- syncStart: '\x1b[?2026h',
38
- syncEnd: '\x1b[?2026l',
39
- };
40
-
41
- function parseArgs(argv) {
42
- const parsed = {
43
- help: false,
44
- status: false,
45
- yes: false,
46
- run: null,
47
- };
48
-
49
- for (let i = 0; i < argv.length; i += 1) {
50
- const arg = argv[i];
51
- switch (arg) {
52
- case '--help':
53
- case '-h':
54
- parsed.help = true;
55
- break;
56
- case '--status':
57
- parsed.status = true;
58
- break;
59
- case '--yes':
60
- parsed.yes = true;
61
- break;
62
- case '--run':
63
- parsed.run = argv[++i] ?? null;
64
- break;
65
- default:
66
- throw new Error(`Unknown argument: ${arg}`);
67
- }
68
- }
69
-
70
- return parsed;
71
- }
72
-
73
- function printHelp() {
74
- console.log(formatHelp(commands));
75
- }
76
-
77
- function printStatus() {
78
- console.log(formatStatusReport(getMenuStatus(rootDir)));
79
- }
80
-
81
- async function runSelectedAction(action, { yes = false, useColor = false } = {}) {
82
- if (action.disabledReason) {
83
- throw new Error(`Action ${action.key} is unavailable here: ${action.disabledReason}`);
84
- }
85
-
86
- if (action.confirmMessage && !yes) {
87
- if (!isInteractiveTerminal()) {
88
- throw new Error(`Action ${action.key} requires --yes outside an interactive terminal.`);
89
- }
90
-
91
- const confirmation = await prompts({
92
- type: 'confirm',
93
- name: 'confirmed',
94
- message: action.confirmMessage,
95
- initial: false,
96
- });
97
-
98
- if (!confirmation.confirmed) {
99
- return { cancelled: true, code: 0 };
100
- }
101
- }
102
-
103
- console.log('');
104
- console.log(formatActionHeader(action, { useColor }));
105
- console.log('');
106
- const code = await runCommand(action, { cwd: action.cwd ?? rootDir });
107
- console.log('');
108
- console.log(formatResultMessage(code, { useColor }));
109
- return { cancelled: false, code };
110
- }
111
-
112
- const readKey = () => new Promise((resolve) => {
113
- process.stdin.once('keypress', (_str, key) => resolve(key));
114
- });
115
-
116
- function createKeyReader() {
117
- const queue = [];
118
- const waiters = [];
119
- const onKeypress = (_str, key) => {
120
- const waiter = waiters.shift();
121
- if (waiter) {
122
- clearTimeout(waiter.timer);
123
- waiter.resolve(key);
124
- return;
125
- }
126
- queue.push(key);
127
- };
128
-
129
- process.stdin.on('keypress', onKeypress);
130
-
131
- return {
132
- read(timeoutMs) {
133
- if (queue.length) return Promise.resolve(queue.shift());
134
- return new Promise((resolve) => {
135
- const waiter = {
136
- resolve,
137
- timer: setTimeout(() => {
138
- const index = waiters.indexOf(waiter);
139
- if (index >= 0) waiters.splice(index, 1);
140
- resolve(null);
141
- }, timeoutMs),
142
- };
143
- waiters.push(waiter);
144
- });
145
- },
146
- close() {
147
- for (const waiter of waiters.splice(0)) {
148
- clearTimeout(waiter.timer);
149
- waiter.resolve(null);
150
- }
151
- process.stdin.off('keypress', onKeypress);
152
- },
153
- };
154
- }
155
-
156
- function setRawInput(enabled) {
157
- if (typeof process.stdin.setRawMode === 'function') {
158
- process.stdin.setRawMode(enabled);
159
- }
160
- if (enabled) process.stdin.resume();
161
- }
162
-
163
- function restoreMenuInput() {
164
- setRawInput(true);
165
- process.stdin.resume();
166
- }
167
-
168
- function enterVisualScreen() {
169
- process.stdout.write(`${CONTROL.alternateScreenIn}${CONTROL.hideCursor}${CONTROL.clearScreen}${CONTROL.cursorHome}`);
170
- }
171
-
172
- function leaveVisualScreen() {
173
- process.stdout.write(`${CONTROL.reset}${CONTROL.showCursor}${CONTROL.alternateScreenOut}`);
174
- }
175
-
176
- function writeStableFrame(frame, { clear = false } = {}) {
177
- const prefix = clear ? CONTROL.clearScreen : '';
178
- process.stdout.write([
179
- CONTROL.syncStart,
180
- CONTROL.cursorHome,
181
- prefix,
182
- frame,
183
- '\n',
184
- CONTROL.clearToEnd,
185
- CONTROL.syncEnd,
186
- ].join(''));
187
- }
188
-
189
- function visualHudAllowed() {
190
- return isInteractiveTerminal()
191
- && process.env.SKILL_MASTER_NO_VISUAL !== '1'
192
- && process.env.CI !== 'true'
193
- && process.env.TERM !== 'dumb';
194
- }
195
-
196
- function renderCyberMenu(selectedIndex, tick, { clear = false } = {}) {
197
- const status = getMenuStatus(rootDir);
198
- const frame = formatCyberMenuFrame(status, commands, selectedIndex, tick, {
199
- columns: process.stdout.columns ?? 120,
200
- rows: process.stdout.rows ?? 32,
201
- useColor: true,
202
- });
203
- writeStableFrame(frame, { clear });
204
- }
205
-
206
- function renderRunningAction(action, tick) {
207
- const status = getMenuStatus(rootDir);
208
- const frame = formatRunningActionFrame(status, action, tick, {
209
- columns: process.stdout.columns ?? 120,
210
- rows: process.stdout.rows ?? 32,
211
- useColor: true,
212
- });
213
- writeStableFrame(frame, { clear: true });
214
- }
215
-
216
- function renderIntro(tick, message) {
217
- const status = getMenuStatus(rootDir);
218
- const frame = formatSkillMasterIntroFrame(status, tick, {
219
- columns: process.stdout.columns ?? 120,
220
- rows: process.stdout.rows ?? 32,
221
- useColor: true,
222
- message,
223
- });
224
- writeStableFrame(frame, { clear: tick === 0 });
225
- }
226
-
227
- function renderConfirmAction(action, tick) {
228
- const status = getMenuStatus(rootDir);
229
- const frame = formatCyberConfirmFrame(status, action, tick, {
230
- columns: process.stdout.columns ?? 120,
231
- rows: process.stdout.rows ?? 32,
232
- useColor: true,
233
- });
234
- writeStableFrame(frame, { clear: tick === 0 });
235
- }
236
-
237
- const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
238
-
239
- async function animateIntro(message = 'skill_master assumindo o workflow', frames = 6) {
240
- for (let frame = 0; frame < frames; frame += 1) {
241
- renderIntro(frame, message);
242
- await sleep(70);
243
- }
244
- }
245
-
246
- async function animateRunningAction(action, startTick) {
247
- for (let frame = 0; frame < 5; frame += 1) {
248
- renderRunningAction(action, startTick + frame);
249
- await sleep(90);
250
- }
251
- }
252
-
253
- async function confirmVisualAction(action, startTick) {
254
- let tick = startTick;
255
- const reader = createKeyReader();
256
-
257
- try {
258
- while (true) {
259
- renderConfirmAction(action, tick);
260
- const key = await reader.read(180);
261
- if (!key) {
262
- tick += 1;
263
- continue;
264
- }
265
-
266
- if (key.ctrl && key.name === 'c') return { confirmed: false, code: 130 };
267
- if (key.name === 'return' || key.name === 'enter' || key.name === 'y') return { confirmed: true, code: 0 };
268
- if (key.name === 'escape' || key.name === 'q' || key.name === 'n') return { confirmed: false, code: 0 };
269
- }
270
- } finally {
271
- reader.close();
272
- }
273
- }
274
-
275
- async function waitForAnyKey(message = 'Pressione qualquer tecla para voltar ao menu...') {
276
- process.stdout.write(`\n${message}`);
277
- setRawInput(true);
278
- await readKey();
279
- setRawInput(false);
280
- }
281
-
282
- async function runVisualMenu() {
283
- let selectedIndex = 0;
284
- let tick = 0;
285
- let lastCode = 0;
286
- let keyReader = createKeyReader();
287
- let previousColumns = process.stdout.columns ?? 120;
288
- let previousRows = process.stdout.rows ?? 32;
289
- let needsClear = true;
290
-
291
- enterVisualScreen();
292
- restoreMenuInput();
293
-
294
- try {
295
- await animateIntro('skill_master online / carregando menu operacional', 7);
296
-
297
- while (true) {
298
- const columns = process.stdout.columns ?? 120;
299
- const rows = process.stdout.rows ?? 32;
300
- const resized = columns !== previousColumns || rows !== previousRows;
301
- previousColumns = columns;
302
- previousRows = rows;
303
- renderCyberMenu(selectedIndex, tick, { clear: needsClear || resized });
304
- needsClear = false;
305
- const key = await keyReader.read(160);
306
-
307
- if (!key) {
308
- tick += 1;
309
- continue;
310
- }
311
-
312
- if (key.ctrl && key.name === 'c') return 130;
313
- if (key.name === 'escape' || key.name === 'q') return lastCode;
314
- if (key.name === 'up' || key.name === 'k') {
315
- selectedIndex = selectedIndex === 0 ? commands.length - 1 : selectedIndex - 1;
316
- continue;
317
- }
318
- if (key.name === 'down' || key.name === 'j') {
319
- selectedIndex = selectedIndex === commands.length - 1 ? 0 : selectedIndex + 1;
320
- continue;
321
- }
322
- if (key.name === 'return' || key.name === 'enter') {
323
- const action = commands[selectedIndex];
324
- keyReader.close();
325
- if (action.confirmMessage) {
326
- const confirmation = await confirmVisualAction(action, tick);
327
- if (confirmation.code === 130) return 130;
328
- if (!confirmation.confirmed) {
329
- keyReader = createKeyReader();
330
- needsClear = true;
331
- continue;
332
- }
333
- }
334
- await animateRunningAction(action, tick);
335
- setRawInput(false);
336
- leaveVisualScreen();
337
- try {
338
- const result = await runSelectedAction(action, { yes: Boolean(action.confirmMessage), useColor: true });
339
- lastCode = result.code;
340
- } catch (error) {
341
- const message = error instanceof Error ? error.message : String(error);
342
- process.stderr.write(`[skill_master] ${message}\n`);
343
- lastCode = 1;
344
- }
345
- await waitForAnyKey();
346
- keyReader = createKeyReader();
347
- restoreMenuInput();
348
- enterVisualScreen();
349
- needsClear = true;
350
- }
351
- }
352
- } finally {
353
- keyReader.close();
354
- setRawInput(false);
355
- process.stdin.pause();
356
- leaveVisualScreen();
357
- }
358
- }
359
-
360
- async function main() {
361
- const args = parseArgs(process.argv.slice(2));
362
-
363
- if (args.help) {
364
- printHelp();
365
- return 0;
366
- }
367
-
368
- if (args.status) {
369
- printStatus();
370
- return 0;
371
- }
372
-
373
- if (args.run) {
374
- const actionKey = resolveActionKey(args.run, commands);
375
- if (!actionKey) {
376
- throw new Error(`Unknown action: ${args.run}`);
377
- }
378
-
379
- const action = commands.find((entry) => entry.key === actionKey);
380
- if (visualHudAllowed()) {
381
- enterVisualScreen();
382
- try {
383
- await animateIntro(`skill_master executando ${action.label}`, 6);
384
- } finally {
385
- leaveVisualScreen();
386
- }
387
- }
388
- const result = await runSelectedAction(action, { yes: args.yes, useColor: isInteractiveTerminal() });
389
- return result.code;
390
- }
391
-
392
- if (!isInteractiveTerminal()) {
393
- throw new Error('Interactive menu requires a TTY. Use --run <acao> or --status in automated environments.');
394
- }
395
-
396
- return runVisualMenu();
397
- }
398
-
399
- try {
400
- process.exitCode = await main();
401
- } catch (error) {
402
- const message = error instanceof Error ? error.message : String(error);
403
- process.stderr.write(`[skill_master] ${message}\n`);
404
- process.exitCode = 1;
405
- }
1
+ #!/usr/bin/env node
2
+
3
+ import prompts from 'prompts';
4
+ import readline from 'node:readline';
5
+ import { dirname } from 'node:path';
6
+ import { fileURLToPath } from 'node:url';
7
+ import {
8
+ buildMenuCommands,
9
+ formatActionHeader,
10
+ formatCyberConfirmFrame,
11
+ formatCyberMenuFrame,
12
+ formatHelp,
13
+ formatRunningActionFrame,
14
+ formatResultMessage,
15
+ formatSkillMasterIntroFrame,
16
+ formatStatusReport,
17
+ getMenuStatus,
18
+ isInteractiveTerminal,
19
+ resolveActionKey,
20
+ resolveInitialSelectedIndex,
21
+ runCommand,
22
+ } from './lib/menu-core.mjs';
23
+
24
+ const currentFile = fileURLToPath(import.meta.url);
25
+ const rootDir = dirname(dirname(currentFile));
26
+ const invocationCwd = process.cwd();
27
+ const commands = buildMenuCommands({ rootDir, currentFile, invocationCwd });
28
+ readline.emitKeypressEvents(process.stdin);
29
+ const CONTROL = {
30
+ alternateScreenIn: '\x1b[?1049h',
31
+ alternateScreenOut: '\x1b[?1049l',
32
+ hideCursor: '\x1b[?25l',
33
+ showCursor: '\x1b[?25h',
34
+ cursorHome: '\x1b[H',
35
+ clearScreen: '\x1b[2J',
36
+ clearToEnd: '\x1b[0J',
37
+ reset: '\x1b[0m',
38
+ syncStart: '\x1b[?2026h',
39
+ syncEnd: '\x1b[?2026l',
40
+ };
41
+
42
+ function parseArgs(argv) {
43
+ const parsed = {
44
+ help: false,
45
+ status: false,
46
+ yes: false,
47
+ run: null,
48
+ };
49
+
50
+ for (let i = 0; i < argv.length; i += 1) {
51
+ const arg = argv[i];
52
+ switch (arg) {
53
+ case '--help':
54
+ case '-h':
55
+ parsed.help = true;
56
+ break;
57
+ case '--status':
58
+ parsed.status = true;
59
+ break;
60
+ case '--yes':
61
+ parsed.yes = true;
62
+ break;
63
+ case '--run':
64
+ parsed.run = argv[++i] ?? null;
65
+ break;
66
+ default:
67
+ throw new Error(`Unknown argument: ${arg}`);
68
+ }
69
+ }
70
+
71
+ return parsed;
72
+ }
73
+
74
+ function printHelp() {
75
+ console.log(formatHelp(commands));
76
+ }
77
+
78
+ function printStatus() {
79
+ console.log(formatStatusReport(getMenuStatus(rootDir)));
80
+ }
81
+
82
+ async function runSelectedAction(action, { yes = false, useColor = false } = {}) {
83
+ if (action.disabledReason) {
84
+ throw new Error(`Action ${action.key} is unavailable here: ${action.disabledReason}`);
85
+ }
86
+
87
+ if (action.confirmMessage && !yes) {
88
+ if (!isInteractiveTerminal()) {
89
+ throw new Error(`Action ${action.key} requires --yes outside an interactive terminal.`);
90
+ }
91
+
92
+ const confirmation = await prompts({
93
+ type: 'confirm',
94
+ name: 'confirmed',
95
+ message: action.confirmMessage,
96
+ initial: false,
97
+ });
98
+
99
+ if (!confirmation.confirmed) {
100
+ return { cancelled: true, code: 0 };
101
+ }
102
+ }
103
+
104
+ console.log('');
105
+ console.log(formatActionHeader(action, { useColor }));
106
+ console.log('');
107
+ const code = await runCommand(action, { cwd: action.cwd ?? rootDir });
108
+ console.log('');
109
+ console.log(formatResultMessage(code, { useColor }));
110
+ return { cancelled: false, code };
111
+ }
112
+
113
+ const readKey = () => new Promise((resolve) => {
114
+ process.stdin.once('keypress', (_str, key) => resolve(key));
115
+ });
116
+
117
+ function createKeyReader() {
118
+ const queue = [];
119
+ const waiters = [];
120
+ const onKeypress = (_str, key) => {
121
+ const waiter = waiters.shift();
122
+ if (waiter) {
123
+ clearTimeout(waiter.timer);
124
+ waiter.resolve(key);
125
+ return;
126
+ }
127
+ queue.push(key);
128
+ };
129
+
130
+ process.stdin.on('keypress', onKeypress);
131
+
132
+ return {
133
+ read(timeoutMs) {
134
+ if (queue.length) return Promise.resolve(queue.shift());
135
+ return new Promise((resolve) => {
136
+ const waiter = {
137
+ resolve,
138
+ timer: setTimeout(() => {
139
+ const index = waiters.indexOf(waiter);
140
+ if (index >= 0) waiters.splice(index, 1);
141
+ resolve(null);
142
+ }, timeoutMs),
143
+ };
144
+ waiters.push(waiter);
145
+ });
146
+ },
147
+ close() {
148
+ for (const waiter of waiters.splice(0)) {
149
+ clearTimeout(waiter.timer);
150
+ waiter.resolve(null);
151
+ }
152
+ process.stdin.off('keypress', onKeypress);
153
+ },
154
+ };
155
+ }
156
+
157
+ function setRawInput(enabled) {
158
+ if (typeof process.stdin.setRawMode === 'function') {
159
+ process.stdin.setRawMode(enabled);
160
+ }
161
+ if (enabled) process.stdin.resume();
162
+ }
163
+
164
+ function restoreMenuInput() {
165
+ setRawInput(true);
166
+ process.stdin.resume();
167
+ }
168
+
169
+ function enterVisualScreen() {
170
+ process.stdout.write(`${CONTROL.alternateScreenIn}${CONTROL.hideCursor}${CONTROL.clearScreen}${CONTROL.cursorHome}`);
171
+ }
172
+
173
+ function leaveVisualScreen() {
174
+ process.stdout.write(`${CONTROL.reset}${CONTROL.showCursor}${CONTROL.alternateScreenOut}`);
175
+ }
176
+
177
+ function writeStableFrame(frame, { clear = false } = {}) {
178
+ const prefix = clear ? CONTROL.clearScreen : '';
179
+ process.stdout.write([
180
+ CONTROL.syncStart,
181
+ CONTROL.cursorHome,
182
+ prefix,
183
+ frame,
184
+ '\n',
185
+ CONTROL.clearToEnd,
186
+ CONTROL.syncEnd,
187
+ ].join(''));
188
+ }
189
+
190
+ function visualHudAllowed() {
191
+ return isInteractiveTerminal()
192
+ && process.env.SKILL_MASTER_NO_VISUAL !== '1'
193
+ && process.env.CI !== 'true'
194
+ && process.env.TERM !== 'dumb';
195
+ }
196
+
197
+ function renderCyberMenu(selectedIndex, tick, { clear = false } = {}) {
198
+ const status = getMenuStatus(rootDir);
199
+ const frame = formatCyberMenuFrame(status, commands, selectedIndex, tick, {
200
+ columns: process.stdout.columns ?? 120,
201
+ rows: process.stdout.rows ?? 32,
202
+ useColor: true,
203
+ });
204
+ writeStableFrame(frame, { clear });
205
+ }
206
+
207
+ function renderRunningAction(action, tick) {
208
+ const status = getMenuStatus(rootDir);
209
+ const frame = formatRunningActionFrame(status, action, tick, {
210
+ columns: process.stdout.columns ?? 120,
211
+ rows: process.stdout.rows ?? 32,
212
+ useColor: true,
213
+ });
214
+ writeStableFrame(frame, { clear: true });
215
+ }
216
+
217
+ function renderIntro(tick, message) {
218
+ const status = getMenuStatus(rootDir);
219
+ const frame = formatSkillMasterIntroFrame(status, tick, {
220
+ columns: process.stdout.columns ?? 120,
221
+ rows: process.stdout.rows ?? 32,
222
+ useColor: true,
223
+ message,
224
+ });
225
+ writeStableFrame(frame, { clear: tick === 0 });
226
+ }
227
+
228
+ function renderConfirmAction(action, tick) {
229
+ const status = getMenuStatus(rootDir);
230
+ const frame = formatCyberConfirmFrame(status, action, tick, {
231
+ columns: process.stdout.columns ?? 120,
232
+ rows: process.stdout.rows ?? 32,
233
+ useColor: true,
234
+ });
235
+ writeStableFrame(frame, { clear: tick === 0 });
236
+ }
237
+
238
+ const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
239
+
240
+ async function animateIntro(message = 'skill_master assumindo o workflow', frames = 6) {
241
+ for (let frame = 0; frame < frames; frame += 1) {
242
+ renderIntro(frame, message);
243
+ await sleep(70);
244
+ }
245
+ }
246
+
247
+ async function animateRunningAction(action, startTick) {
248
+ for (let frame = 0; frame < 5; frame += 1) {
249
+ renderRunningAction(action, startTick + frame);
250
+ await sleep(90);
251
+ }
252
+ }
253
+
254
+ async function confirmVisualAction(action, startTick) {
255
+ let tick = startTick;
256
+ const reader = createKeyReader();
257
+
258
+ try {
259
+ while (true) {
260
+ renderConfirmAction(action, tick);
261
+ const key = await reader.read(180);
262
+ if (!key) {
263
+ tick += 1;
264
+ continue;
265
+ }
266
+
267
+ if (key.ctrl && key.name === 'c') return { confirmed: false, code: 130 };
268
+ if (key.name === 'return' || key.name === 'enter' || key.name === 'y') return { confirmed: true, code: 0 };
269
+ if (key.name === 'escape' || key.name === 'q' || key.name === 'n') return { confirmed: false, code: 0 };
270
+ }
271
+ } finally {
272
+ reader.close();
273
+ }
274
+ }
275
+
276
+ async function waitForAnyKey(message = 'Pressione qualquer tecla para voltar ao menu...') {
277
+ process.stdout.write(`\n${message}`);
278
+ setRawInput(true);
279
+ await readKey();
280
+ setRawInput(false);
281
+ }
282
+
283
+ async function runVisualMenu() {
284
+ let selectedIndex = resolveInitialSelectedIndex(getMenuStatus(rootDir), commands);
285
+ let tick = 0;
286
+ let lastCode = 0;
287
+ let keyReader = createKeyReader();
288
+ let previousColumns = process.stdout.columns ?? 120;
289
+ let previousRows = process.stdout.rows ?? 32;
290
+ let needsClear = true;
291
+
292
+ enterVisualScreen();
293
+ restoreMenuInput();
294
+
295
+ try {
296
+ await animateIntro('skill_master online / carregando menu operacional', 7);
297
+
298
+ while (true) {
299
+ const columns = process.stdout.columns ?? 120;
300
+ const rows = process.stdout.rows ?? 32;
301
+ const resized = columns !== previousColumns || rows !== previousRows;
302
+ previousColumns = columns;
303
+ previousRows = rows;
304
+ renderCyberMenu(selectedIndex, tick, { clear: needsClear || resized });
305
+ needsClear = false;
306
+ const key = await keyReader.read(160);
307
+
308
+ if (!key) {
309
+ tick += 1;
310
+ continue;
311
+ }
312
+
313
+ if (key.ctrl && key.name === 'c') return 130;
314
+ if (key.name === 'escape' || key.name === 'q') return lastCode;
315
+ if (key.name === 'up' || key.name === 'k') {
316
+ selectedIndex = selectedIndex === 0 ? commands.length - 1 : selectedIndex - 1;
317
+ continue;
318
+ }
319
+ if (key.name === 'down' || key.name === 'j') {
320
+ selectedIndex = selectedIndex === commands.length - 1 ? 0 : selectedIndex + 1;
321
+ continue;
322
+ }
323
+ if (key.name === 'return' || key.name === 'enter') {
324
+ const action = commands[selectedIndex];
325
+ keyReader.close();
326
+ if (action.confirmMessage) {
327
+ const confirmation = await confirmVisualAction(action, tick);
328
+ if (confirmation.code === 130) return 130;
329
+ if (!confirmation.confirmed) {
330
+ keyReader = createKeyReader();
331
+ needsClear = true;
332
+ continue;
333
+ }
334
+ }
335
+ await animateRunningAction(action, tick);
336
+ setRawInput(false);
337
+ leaveVisualScreen();
338
+ try {
339
+ const result = await runSelectedAction(action, { yes: Boolean(action.confirmMessage), useColor: true });
340
+ lastCode = result.code;
341
+ } catch (error) {
342
+ const message = error instanceof Error ? error.message : String(error);
343
+ process.stderr.write(`[skill_master] ${message}\n`);
344
+ lastCode = 1;
345
+ }
346
+ await waitForAnyKey();
347
+ keyReader = createKeyReader();
348
+ restoreMenuInput();
349
+ enterVisualScreen();
350
+ needsClear = true;
351
+ }
352
+ }
353
+ } finally {
354
+ keyReader.close();
355
+ setRawInput(false);
356
+ process.stdin.pause();
357
+ leaveVisualScreen();
358
+ }
359
+ }
360
+
361
+ async function main() {
362
+ const args = parseArgs(process.argv.slice(2));
363
+
364
+ if (args.help) {
365
+ printHelp();
366
+ return 0;
367
+ }
368
+
369
+ if (args.status) {
370
+ printStatus();
371
+ return 0;
372
+ }
373
+
374
+ if (args.run) {
375
+ const actionKey = resolveActionKey(args.run, commands);
376
+ if (!actionKey) {
377
+ throw new Error(`Unknown action: ${args.run}`);
378
+ }
379
+
380
+ const action = commands.find((entry) => entry.key === actionKey);
381
+ if (visualHudAllowed()) {
382
+ enterVisualScreen();
383
+ try {
384
+ await animateIntro(`skill_master executando ${action.label}`, 6);
385
+ } finally {
386
+ leaveVisualScreen();
387
+ }
388
+ }
389
+ const result = await runSelectedAction(action, { yes: args.yes, useColor: isInteractiveTerminal() });
390
+ return result.code;
391
+ }
392
+
393
+ if (!isInteractiveTerminal()) {
394
+ throw new Error('Interactive menu requires a TTY. Use --run <acao> or --status in automated environments.');
395
+ }
396
+
397
+ return runVisualMenu();
398
+ }
399
+
400
+ try {
401
+ process.exitCode = await main();
402
+ } catch (error) {
403
+ const message = error instanceof Error ? error.message : String(error);
404
+ process.stderr.write(`[skill_master] ${message}\n`);
405
+ process.exitCode = 1;
406
+ }