bps-kit 1.0.15 → 1.0.17

package/CHANGELOG.md

@@ -5,6 +5,17 @@ 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.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.
+
 ## [1.0.15] - 2026-03-08
 ### Corrigido
 - Eliminado Overhead Brutal (+66 Referências Vias Copilot) mudando os Markdowns de Skills ativas para uma pasta raiz independente `.copilot-skills/` em vez de abrigá-las no escopo autônomo do `.github/`.

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...'));
 
@@ -24,7 +21,10 @@ async function convertToVsCode(destAgents, destBase) {
         content = content.replace(/\.\/\.agents\/skills\//g, './.copilot-skills/');
         content = content.replace(/\.\/\.agents\/vault\//g, './.copilot-vault/');
         content = content.replace(/\.\/\.agents\/rules\/GEMINI\.md/g, './.github/copilot-instructions.md');
-        content = content.replace(/\{skill-name\}\/SKILL\.md/g, '{skill-name}.md'); // Para buscar arquivos achatados invés de diretórios
+        content = content.replace(/\.\/\.agents\/VAULT_INDEX\.md/g, './.github/VAULT_INDEX.md');
+
+        // Copilot precisa ser avisado de que as skills ativas agora requerem leitura ativa (view_file) fora da injecao limitante do contexto
+        content = content.replace(/— always in context/g, '— explicitly read the SKILL.md file via file tools before using');
 
         // Trocar sintaxe bruta de trigger pelo ApplyTo nativo
         content = content.replace(/trigger:\s*always_on/g, 'applyTo: "**/*"');
@@ -35,22 +35,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)
@@ -58,8 +49,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);
     }
 
@@ -106,11 +95,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.15",
+  "version": "1.0.17",
   "description": "BPS Kit - The Ultimate Antigravity Brain",
   "bin": {
     "bps-kit": "./bin/cli.js"

package/templates/VAULT_INDEX.md

@@ -1,7 +1,7 @@
 # 🗄️ Vault Index
 
-> 1197 skills in `./.agents/antigravity/vault/`.
-> To use: `view_file ./.agents/antigravity/vault/{skill-name}/SKILL.md`
+> 1197 skills in `./.agents/vault/`.
+> To use: `view_file ./.agents/vault/{skill-name}/SKILL.md`
 
 ## Web & Frontend (53)
 3d-web-experience angular angular-best-practices angular-migration angular-state-management angular-ui-patterns animejs-animation antigravity-design-expert antigravity-workflows baseline-ui chrome-extension-developer cloudflare-workers-expert design-md design-orchestration design-spells frontend-dev-guidelines frontend-mobile-development-component-scaffold frontend-mobile-security-xss-scan frontend-security-coder frontend-slides frontend-ui-dark-ts html-injection-testing nextjs-app-router-patterns radix-ui-design-system react-best-practices react-flow-architect react-flow-node-ts react-modernization react-native-architecture react-nextjs-development react-state-management react-ui-patterns spline-3d-integration tailwind-design-system threejs-animation threejs-fundamentals threejs-geometry threejs-interaction threejs-lighting threejs-loaders threejs-materials threejs-postprocessing threejs-shaders threejs-skills threejs-textures ui-skills ui-ux-pro-max ui-visual-validator web-artifacts-builder web-design-guidelines web-scraper web-security-testing webflow-automation

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

@@ -67,16 +67,16 @@ 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/antigravity/skills/` — always in context
-- **Vault skills** (~1200+): in `./.agents/antigravity/vault/` — discoverable via index
+- **Active skills** (~65): in `./.agents/skills/` — always in context
+- **Vault skills** (~1200+): in `./.agents/vault/` — discoverable via index
 
 ### Core Rule — Skills First
 After invoking any skill, explicitly say: '📖 Using skill: [skill-name]' before proceeding. If no skill was used, say: '⚠️ No skill used — responding from base knowledge.'
 
 ### Routing Flow
 1. Check if an **active skill** covers the request → use it directly
-2. If not → open `./.agents/antigravity/skills/VAULT_INDEX.md` to find a vault skill
-3. If found → `view_file ./.agents/antigravity/vault/{name}/SKILL.md`
+2. If not → open `./.agents/VAULT_INDEX.md` to find a vault skill
+3. If found → `view_file ./.agents/vault/{name}/SKILL.md`
 4. If nothing found → respond from base knowledge
 
 ### Intent → Skill Routing Map (Active Skills)