bps-kit 1.0.16 → 1.0.18

package/CHANGELOG.md

@@ -5,6 +5,18 @@ Todas as mudanças notáveis ​​neste projeto serão documentadas neste arqui
 O formato é baseado no [Keep a Changelog](https://keepachangelog.com/pt-BR/1.0.0/), 
 e este projeto adere ao [Versionamento Semântico](https://semver.org/lang/pt-BR/).
 
+## [1.0.18] - 2026-03-08
+### Modificado
+- Universalização do *Lazy-Loading*: A instrução contida no template base `GEMINI.md` dizia que as habilidades (skills) na pasta raíz estariam "*always in context*" (sempre no contexto). Essa linha foi alterada para um comando forte que impõe as IAs nativas (Windsurf e Cursor) lerem a habilidade "explicitly read the SKILL.md file via file tools before using". Isso universaliza a redução de uso de Tokens Passivos (barrando possíveis alucinações de contexto) em todas as esferas e não apenas na arquitetura VS Code Copilot.
+- Com isso, o construtor do VS Code (`convert_to_vscode.js`) não precisa mais realizar uma conversão *custom* desta *string* especifica visto que a performance de token foi regularizada no template Global.
+
+## [1.0.17] - 2026-03-08
+### Corrigido
+- O script `convert_to_vscode.js` esvaziava os metadados e scripts em Python de `.copilot-skills/` durante o processo de migração por achatar ativamente e destrutivamente pastas em um `.md` individual. O conversor agora move a pasta preservando a sanidade estrutural e utilitária de cada *skill*.
+- Regex deficiente fazia com que as worklows base herdadas referissem-se à pastas extintas (`.github/skills`). Normalizado para ditar o ponteiro `.copilot-skills/`.
+- Deletado rastros estáticos e zumbis que persistiam a criar uma pasta `.github/instructions` vazia, causando confusão a usuários inspecionando o repositório.
+- A regra global *GEMINI* foi adequada para informar ao Copilot para ativamente ler (`view_file`) skills em vez de achar estáticamente que já estão no seu contexto (como era no pre-requisito original para a IDE Cursor).
+
 ## [1.0.16] - 2026-03-08
 ### Corrigido
 - Sincronização dos Paths Estáticos: O template global do projeto (`GEMINI.md`) possuía vestígios do path absoluto de leitura desvinculadas às regras autônomas implementadas para instâncias individuais. Isto estava impedindo o construtor regex do backend (`convert_to_vscode.js`) de ler e traduzir os caminhos originais em caminhos ocultados apropriados para lidar com o GitHub Copilot Agent.

package/bin/convert_to_vscode.js

@@ -9,9 +9,6 @@ const chalk = require('chalk');
  */
 async function convertToVsCode(destAgents, destBase) {
     const gitHubDir = path.join(destBase, '.github');
-    const copilotInstructionsDir = path.join(gitHubDir, 'instructions');
-
-    await fs.ensureDir(copilotInstructionsDir);
 
     console.log(chalk.dim('   [VS Code] Convertendo arquivos para sintaxe do Copilot...'));
 
@@ -25,7 +22,6 @@ async function convertToVsCode(destAgents, destBase) {
         content = content.replace(/\.\/\.agents\/vault\//g, './.copilot-vault/');
         content = content.replace(/\.\/\.agents\/rules\/GEMINI\.md/g, './.github/copilot-instructions.md');
         content = content.replace(/\.\/\.agents\/VAULT_INDEX\.md/g, './.github/VAULT_INDEX.md');
-        content = content.replace(/\{skill-name\}\/SKILL\.md/g, '{skill-name}.md'); // Para buscar arquivos achatados invés de diretórios
 
         // Trocar sintaxe bruta de trigger pelo ApplyTo nativo
         content = content.replace(/trigger:\s*always_on/g, 'applyTo: "**/*"');
@@ -36,22 +32,13 @@ async function convertToVsCode(destAgents, destBase) {
         await fs.writeFile(path.join(gitHubDir, 'copilot-instructions.md'), content);
     }
 
-    // 2. Converter as skills nativas (ativas) em arquivo comum .md achatado
+    // 2. Mover as skills ativas inteiras (em vez de achatar) para preservar scripts em python embutidos e sub documentações!
     // Importante: NÃO alocamos em .github/skills pois o Copilot engole todos os Markdowns de lá e causa sobrecarga de +60 referências!
     const skillsDest = path.join(destAgents, 'skills');
     const copilotSkillsDir = path.join(destBase, '.copilot-skills');
-    await fs.ensureDir(copilotSkillsDir);
 
     if (await fs.pathExists(skillsDest)) {
-        const skillsDirs = await fs.readdir(skillsDest);
-        for (const skillName of skillsDirs) {
-            const skillFile = path.join(skillsDest, skillName, 'SKILL.md');
-            if (await fs.pathExists(skillFile)) {
-                let content = await fs.readFile(skillFile, 'utf8');
-                // Salvar como .md comum achatado para a IA consultar dinamicamente via "file read" só quando requisitado
-                await fs.writeFile(path.join(copilotSkillsDir, `${skillName}.md`), content);
-            }
-        }
+        await fs.move(skillsDest, copilotSkillsDir, { overwrite: true });
     }
 
     // 3. Converter o Vault Index (Tudo que esta no index vira uma instrução consultável)
@@ -59,8 +46,6 @@ async function convertToVsCode(destAgents, destBase) {
     if (await fs.pathExists(vaultIndexSrc)) {
         let content = await fs.readFile(vaultIndexSrc, 'utf8');
         content = content.replace(/\.\/\.agents\/vault\//g, './.copilot-vault/');
-        // Também trocar eventuais menções de SKILL.md para o formato achatado.md do VSCode
-        content = content.replace(/\{name\}\/SKILL\.md/g, '{name}.md');
         await fs.writeFile(path.join(gitHubDir, 'VAULT_INDEX.md'), content);
     }
 
@@ -107,11 +92,13 @@ ${content}`;
                 const promptName = workflow.replace('.md', '');
 
                 // Converter referências visuais e lógicas residuais do Antigravity nativo 
-                // para o equivalente funcional da arquitetura VS Code.
+                // para o equivalente funcional da arquitetura VS Code de forma escalonada!
                 content = content.replace(/\.\/\.agents\/rules\/GEMINI\.md/g, './.github/copilot-instructions.md');
+                content = content.replace(/\.\/\.agents\/skills\//g, './.copilot-skills/');
+                content = content.replace(/\.\/\.agents\/vault\//g, './.copilot-vault/');
+                content = content.replace(/\.\/\.agents\/VAULT_INDEX\.md/g, './.github/VAULT_INDEX.md');
                 content = content.replace(/\.\/\.agents\//g, './.github/');
                 content = content.replace(/GEMINI\.md/g, 'copilot-instructions.md');
-                content = content.replace(/VAULT_INDEX\.md/g, 'VAULT_INDEX.md');
 
                 // Formato exigido para GitHub Copilot Prompts (.prompt.md)
                 const vsCodePromptContent = `---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bps-kit",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "BPS Kit - The Ultimate Antigravity Brain",
   "bin": {
     "bps-kit": "./bin/cli.js"

package/templates/agents-template/rules/GEMINI.md

@@ -67,7 +67,7 @@ Agent activated → Check frontmatter "skills:" → Read SKILL.md (INDEX) → Re
 ## 🧠 Skill Auto-Routing System (v8.0.0 — Vault Edition)
 
 ### Architecture
-- **Active skills** (~65): in `./.agents/skills/` — always in context
+- **Active skills** (~65): in `./.agents/skills/` — explicitly read the SKILL.md file via file tools before using
 - **Vault skills** (~1200+): in `./.agents/vault/` — discoverable via index
 
 ### Core Rule — Skills First