sinapse-ai 1.25.3 → 1.26.0

package/.agents/skills/react-bits-frontend/SKILL.md

@@ -10,8 +10,16 @@ not as a black-box library.
 
 ## Locate the corpus
 
-Resolve the SINAPSE package/repository root, then read
-`docs/framework/react-bits/index.md`. Read only the category needed:
+Resolve the corpus in this exact order, then read `index.md` from the first
+location that contains the complete corpus:
+
+1. `<project>/docs/framework/react-bits/`
+2. `<installed-package>/docs/framework/react-bits/`
+3. `~/.sinapse/docs/framework/react-bits/`
+
+The project location wins so a project can pin or extend its installed research.
+The package location supports package-managed runs, and the global SINAPSE home
+supports `--global-only` installs. Read only the category needed:
 
 - `animations.md` for wrappers, cursors, trails, transitions and interactive effects.
 - `text-animations.md` for headline, counter, scramble, marquee and reveal work.
@@ -21,8 +29,9 @@ Resolve the SINAPSE package/repository root, then read
 - `audit-findings.md` when dependency, prop, variant or upstream accuracy matters.
 - `inventory.json` for exact machine-readable props, dependencies and variant state.
 
-If the corpus cannot be found, read `references/corpus-map.md`, then verify current
-facts against the official registry and source before implementation.
+If none of those locations has all nine files, state which locations were checked,
+ask the user to run the relevant SINAPSE install/update, then verify current facts
+against the official registry and source before implementation.
 
 ## Workflow
 

package/.claude/skill-manifest.json

@@ -1,6 +1,7 @@
 {
   "version": 1,
   "skillIds": [
+    "react-bits-frontend",
     "sinapse",
     "sinapse-agent",
     "sinapse-analyst",

package/.claude/skills/react-bits-frontend/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: react-bits-frontend
+description: Select, install, adapt, combine, optimize, and audit official React Bits components for React, Next.js, Vite, Astro islands, and SINAPSE frontend projects. Use for animated text, cursors, reveals, cards, navigation, galleries, WebGL backgrounds, shaders, particles, motion systems, React Bits CLI/MCP commands, component props/dependencies, or when improving an existing page with React Bits while preserving accessibility, mobile performance, lifecycle cleanup, design-system fit, and license compliance.
+---
+
+# React Bits Frontend
+
+Use the source-grounded SINAPSE corpus to implement React Bits as application code,
+not as a black-box library.
+
+## Locate the corpus
+
+Resolve the corpus in this exact order, then read `index.md` from the first
+location that contains the complete corpus:
+
+1. `<project>/docs/framework/react-bits/`
+2. `<installed-package>/docs/framework/react-bits/`
+3. `~/.sinapse/docs/framework/react-bits/`
+
+The project location wins so a project can pin or extend its installed research.
+The package location supports package-managed runs, and the global SINAPSE home
+supports `--global-only` installs. Read only the category needed:
+
+- `animations.md` for wrappers, cursors, trails, transitions and interactive effects.
+- `text-animations.md` for headline, counter, scramble, marquee and reveal work.
+- `components.md` for cards, navigation, galleries, inputs and compound UI.
+- `backgrounds.md` for Canvas/WebGL/shader/particle backgrounds.
+- `implementation-playbook.md` for integration, composition, accessibility and tuning.
+- `audit-findings.md` when dependency, prop, variant or upstream accuracy matters.
+- `inventory.json` for exact machine-readable props, dependencies and variant state.
+
+If none of those locations has all nine files, state which locations were checked,
+ask the user to run the relevant SINAPSE install/update, then verify current facts
+against the official registry and source before implementation.
+
+## Workflow
+
+1. Inspect the target stack, component architecture, design tokens, performance budget
+   and existing animation/scroll ownership.
+2. Translate the visual request into a user-experience function.
+3. Search the relevant catalog and shortlist at most three candidates.
+4. Compare visual fit, dependencies, runtime engine, props, interaction model,
+   accessibility, mobile cost and compatibility with existing effects.
+5. Open the official source for the selected variant. Treat source and registry as
+   authoritative when docs conflict.
+6. Run `npm view <package>` for every declared dependency before installing it.
+7. Prefer TS-TW or TS-CSS in TypeScript projects. Never use the three empty CurvedInput
+   variants recorded in the snapshot; use JS-CSS or verify that upstream fixed them.
+8. Install through shadcn/jsrepo or copy manually. Keep upstream provenance and the
+   required license notice for substantial copies.
+9. Wrap the imported component behind a local application component. Map design
+   tokens, content, breakpoints and quality presets at that boundary.
+10. Implement reduced-motion behavior, semantic fallback, keyboard/focus behavior,
+    cleanup and static/mobile fallback.
+11. Test load, resize, route unmount/remount, long scroll, coarse pointer, reduced
+    motion and low-power mobile. Measure frame time and memory.
+12. Report component, variant, source SHA/URL, dependencies, adaptations, fallbacks and
+    remaining risks.
+
+## Composition rules
+
+- Use one dominant motion effect per viewport and no more than two support effects.
+- Prefer the lowest-cost engine that satisfies the visual objective.
+- Allow only one owner for smooth scroll, custom cursor and each render loop.
+- Do not stack multiple heavy WebGL/physics backgrounds without an explicit budget.
+- Pause offscreen/hidden loops and dispose GPU resources on unmount.
+- Preserve content and interaction when animation is disabled or fails.
+
+## Accuracy rules
+
+- Do not repeat the promotional “140+” as an exact count. The pinned snapshot has 139.
+- Do not infer functional variants from registry names alone; inspect source bytes/code.
+- Use registry JSON for install dependencies and source for actual API/behavior.
+- Note documentation typos and per-variant divergences from `audit-findings.md`.
+- Do not redistribute React Bits components as a standalone library, bundle, or port.

package/.codex/scripts/sync-codex-native.js

@@ -34,6 +34,10 @@ function isPathInside(parentPath, candidatePath) {
   return relative === '' || (!relative.startsWith('..') && !path.isAbsolute(relative));
 }
 
+function isSafeSkillId(skillId) {
+  return typeof skillId === 'string' && /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(skillId);
+}
+
 function readCanonicalSource(projectRoot, sourcePath) {
   if (!sourcePath) {
     throw new Error('Codex agent pointer does not declare a canonical source');
@@ -329,6 +333,14 @@ function readCodexCatalog(projectRoot = PROJECT_ROOT) {
   if (typeof catalog.genericAgentSkillId !== 'string' || !catalog.genericAgentSkillId.trim()) {
     throw new Error('Codex catalog does not declare genericAgentSkillId');
   }
+  const catalogSkillIds = [
+    ...catalog.expectedSkillIds,
+    ...catalog.publicAliasSkillIds,
+    catalog.genericAgentSkillId,
+  ];
+  if (catalogSkillIds.some((skillId) => !isSafeSkillId(skillId))) {
+    throw new Error('Codex catalog contains an unsafe skill ID');
+  }
   return catalog;
 }
 

package/.sinapse-ai/install-manifest.yaml

@@ -7,7 +7,7 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 1.25.3
+version: 1.26.0
 generator: scripts/generate-install-manifest.js
 file_count: 1156
 files:

package/CHANGELOG.md

@@ -1,8 +1,17 @@
-## [1.25.3](https://github.com/caioimori/sinapse-ai/compare/1.25.2...1.25.3) (2026-07-15)
+## [1.26.0](https://github.com/caioimori/sinapse-ai/compare/1.25.3...1.26.0) (2026-07-15)
+
+### Features
+
+* deliver React Bits across providers [Story react-bits-distribution-parity] ([aa191f1](https://github.com/caioimori/sinapse-ai/commit/aa191f102dc417e3a0182c02661907e474226abb))
 
 ### Bug Fixes
 
-* **installer:** restore provider adapter parity ([#385](https://github.com/caioimori/sinapse-ai/issues/385)) ([4c5c9fb](https://github.com/caioimori/sinapse-ai/commit/4c5c9fb1a60e5d8610da08f25f6f01a67a85a063))
+* **docs:** align provider skill metrics [Story react-bits-distribution-parity] ([729d120](https://github.com/caioimori/sinapse-ai/commit/729d120ee1735473d01971efdb746be59d2d19d8))
+* **react-bits:** harden corpus delivery and orchestration [Story react-bits-distribution-parity] ([6456062](https://github.com/caioimori/sinapse-ai/commit/6456062cd756826e6bc14c698ebde07298d8a5eb))
+
+### Documentation
+
+* close installer parity release evidence [Story hotfix-installer-provider-adapter-parity-1.25.3] ([#386](https://github.com/caioimori/sinapse-ai/issues/386)) ([ceafcb8](https://github.com/caioimori/sinapse-ai/commit/ceafcb8ac522835c264115e9ee16cba6e49e173c))
 
 # Changelog
 

package/README.en.md

@@ -309,7 +309,7 @@ Both IDEs have access to all 17 squads, 172 agents, workflows, and knowledge bas
 | Native agents | 172 | 172 |
 | Direct activation | `@agent-name` | `$sinapse-agent agent-id` |
 | Primary routing | `@sinapse-orqx` | `$snps` |
-| Installed skills | 36 | 37 |
+| Installed skills | 37 | 37 |
 | Registered hooks | 20 native registrations | 9 lifecycle events through the bridge |
 | Validation source | `npm run validate:providers` | `npm run validate:codex-native` |
 

package/README.md

@@ -331,7 +331,7 @@ Ambas as IDEs têm acesso a todos os 17 squads, 172 agentes, workflows e knowled
 | Agentes nativos | 172 | 172 |
 | Ativação direta | `@agent-name` | `$sinapse-agent agent-id` |
 | Roteamento principal | `@sinapse-orqx` | `$snps` |
-| Skills instaladas | 36 | 37 |
+| Skills instaladas | 37 | 37 |
 | Hooks registrados | 20 registros nativos | 9 eventos de lifecycle via bridge |
 | Fonte de validação | `npm run validate:providers` | `npm run validate:codex-native` |
 

package/bin/commands/install.js

@@ -50,6 +50,10 @@ const {
 } = require('../lib/command-generator');
 const { deliverGlobalProviderAdapters, getGlobalCommandStagingDir } = require('../lib/global-provider-adapters');
 const { assertProviderAdapterParity } = require('../lib/provider-parity');
+const {
+  copyReactBitsCapabilitySync,
+  REACT_BITS_SKILL_RELATIVE_PATH,
+} = require('../../packages/installer/src/installer/react-bits-corpus');
 // Follow-up #13 — wire the transactional backup/rollback engine into the
 // installer so an in-place UPGRADE (upsert) that fails mid-flight is restored
 // to its previous state instead of leaving ~/.sinapse half-updated.
@@ -317,7 +321,12 @@ async function cmdInstallGlobal(opts = {}) {
   // rich, frontmatter'd stubs are always the final word. Idempotent.
   try {
     const commandsDir = getGlobalCommandStagingDir({ llmChoice, sinapseHome: SINAPSE_HOME, claudeCommandsDir: CLAUDE_COMMANDS_DIR });
-    const reconciled = deliverGlobalProviderAdapters({ llmChoice, home: HOME, commandsDir });
+    const reconciled = deliverGlobalProviderAdapters({
+      llmChoice,
+      home: HOME,
+      commandsDir,
+      reactBitsSkillPath: path.join(SINAPSE_HOME, REACT_BITS_SKILL_RELATIVE_PATH),
+    });
     const total = reconciled.claude.length + reconciled.codex.length + reconciled.skills.length;
     if (total) logger.always(`  ${GREEN}OK${NC} Global provider adapters reconciled (${total} artifacts)`);
   } catch (e) {
@@ -557,6 +566,9 @@ function installFatalPhases({ squads, squadsDir, isUpsert, llmChoice, existing,
     logger.always(`  ${GREEN}OK${NC} core development (${coreAgents} agents)`);
   }
 
+  const reactBits = copyReactBitsCapabilitySync(ROOT, SINAPSE_HOME);
+  if (reactBits.files.length) logger.always(`  ${GREEN}OK${NC} React Bits corpus (${reactBits.files.length} files)`);
+
   // Phase 2: Generate agent commands (shared with `update` via command-generator).
   logger.always(`\n${CYAN}Phase 2:${NC} Generating agent commands`);
   const commandStagingDir = getGlobalCommandStagingDir({ llmChoice, sinapseHome: SINAPSE_HOME, claudeCommandsDir: CLAUDE_COMMANDS_DIR });
@@ -570,7 +582,12 @@ function installFatalPhases({ squads, squadsDir, isUpsert, llmChoice, existing,
   logger.always(`  ${GREEN}OK${NC} ${writtenAgents.size} total command files`);
 
   // Phase 2b: Install global agents based on LLM choice
-  const globalAdapters = deliverGlobalProviderAdapters({ llmChoice, home: HOME, commandsDir: commandStagingDir });
+  const globalAdapters = deliverGlobalProviderAdapters({
+    llmChoice,
+    home: HOME,
+    commandsDir: commandStagingDir,
+    reactBitsSkillPath: path.join(SINAPSE_HOME, REACT_BITS_SKILL_RELATIVE_PATH),
+  });
   const activeAgentCount = assertProviderAdapterParity(
     llmChoice,
     globalAdapters,

package/bin/commands/uninstall.js

@@ -170,7 +170,7 @@ function removeOrqxAgentsFrom(dir) {
   return removeInstalledAgentsFrom(dir);
 }
 
-const MANAGED_GLOBAL_SKILL_IDS = ['snps', 'sinapse', 'snps-orqx', 'sinapse-orqx', 'sinapse-agent'];
+const MANAGED_GLOBAL_SKILL_IDS = ['snps', 'sinapse', 'snps-orqx', 'sinapse-orqx', 'sinapse-agent', 'react-bits-frontend'];
 const MANAGED_GLOBAL_SKILL_MARKER = 'SINAPSE-MANAGED:global-skill';
 
 function removeManagedGlobalSkills(home = HOME, options = {}) {

package/bin/commands/update.js

@@ -36,6 +36,10 @@ const {
 } = require('./uninstall');
 const { regenerateAgentCommands } = require('../lib/command-generator');
 const { deliverGlobalProviderAdapters, getGlobalCommandStagingDir } = require('../lib/global-provider-adapters');
+const {
+  copyReactBitsCapabilitySync,
+  REACT_BITS_SKILL_RELATIVE_PATH,
+} = require('../../packages/installer/src/installer/react-bits-corpus');
 const { assertProviderAdapterParity } = require('../lib/provider-parity');
 const { execSync } = require('child_process');
 
@@ -164,6 +168,9 @@ async function cmdUpdateGlobal() {
     logger.always(`  ${GREEN}OK${NC} core development`);
   }
 
+  const reactBits = copyReactBitsCapabilitySync(ROOT, SINAPSE_HOME);
+  if (reactBits.files.length) logger.always(`  ${GREEN}OK${NC} React Bits corpus (${reactBits.files.length} files)`);
+
   // Phase 2: Regenerate commands — shared with `install` so `update` produces the
   // SAME complete set (every specialist command + the rich master Imperator stubs),
   // not just the `-orqx` subset it used to write.
@@ -180,7 +187,12 @@ async function cmdUpdateGlobal() {
   logger.always(`  ${GREEN}OK${NC} ${writtenAgents.size} command files (${totalAgents} agents total)`);
 
   // Phase 2b: Install global agents based on LLM choice
-  const globalAdapters = deliverGlobalProviderAdapters({ llmChoice, home: HOME, commandsDir: commandStagingDir });
+  const globalAdapters = deliverGlobalProviderAdapters({
+    llmChoice,
+    home: HOME,
+    commandsDir: commandStagingDir,
+    reactBitsSkillPath: path.join(SINAPSE_HOME, REACT_BITS_SKILL_RELATIVE_PATH),
+  });
   const activeAgentCount = assertProviderAdapterParity(
     llmChoice,
     globalAdapters,

package/bin/lib/global-provider-adapters.js

@@ -6,6 +6,7 @@ const crypto = require('crypto');
 const {
   MASTER_ALIAS_ENTRY_POINTS,
   GLOBAL_PROVIDER_SKILL_IDS,
+  GLOBAL_SUPPLEMENTAL_PROVIDER_SKILL_IDS,
   SUPREME_ORCHESTRATOR_ID,
   SUPREME_PUBLIC_ID,
 } = require('./provider-contract');
@@ -102,7 +103,11 @@ function markGlobalAgent(markdown, fileName = '') {
   return `${content.trimEnd()}\n\n<!-- SINAPSE-MANAGED:global-agent -->\n`;
 }
 
-function renderGlobalSkill(skillId) {
+function renderGlobalSkill(skillId, sourceContent = null) {
+  if (skillId === 'react-bits-frontend') {
+    if (!sourceContent) throw new Error('React Bits global skill source is required');
+    return `${String(sourceContent).trimEnd()}\n\n<!-- SINAPSE-MANAGED:global-skill -->\n`;
+  }
   const generic = skillId === 'sinapse-agent';
   return [
     '---',
@@ -264,9 +269,9 @@ function writeGlobalSkillIfManaged(skillPath, content, home = path.dirname(skill
   }
 }
 
-function isValidGlobalSkill(skillId, skillPath) {
+function isValidGlobalSkill(skillId, skillPath, sourceContent = null) {
   const content = readRegularFileNoFollowSync(skillPath, 'utf8');
-  return content !== null && content === renderGlobalSkill(skillId);
+  return content !== null && content === renderGlobalSkill(skillId, sourceContent);
 }
 
 function removeStaleManagedAgents(targetDir, expectedFiles, extension, options = {}) {
@@ -318,7 +323,7 @@ function removeManagedFileWithBinding(home, filePath, beforeDelete) {
   }
 }
 
-function deliverGlobalProviderAdapters({ llmChoice, home, commandsDir, testHooks = {} }) {
+function deliverGlobalProviderAdapters({ llmChoice, home, commandsDir, reactBitsSkillPath, testHooks = {} }) {
   let commandFiles = fs.existsSync(commandsDir)
     ? fs.readdirSync(commandsDir).filter((file) => file.endsWith('.md')).sort()
     : [];
@@ -334,6 +339,13 @@ function deliverGlobalProviderAdapters({ llmChoice, home, commandsDir, testHooks
     skills: [],
     availableSkills: [],
   };
+  let reactBitsSkillContent = null;
+  const providerSkillIds = [...GLOBAL_PROVIDER_SKILL_IDS];
+  if (reactBitsSkillPath) {
+    reactBitsSkillContent = readRegularFileNoFollowSync(reactBitsSkillPath, 'utf8');
+    if (reactBitsSkillContent === null) throw new Error(`React Bits global skill is missing: ${reactBitsSkillPath}`);
+    providerSkillIds.push(...GLOBAL_SUPPLEMENTAL_PROVIDER_SKILL_IDS);
+  }
 
   if (llmChoice === 'claude-code' || llmChoice === 'both') {
     const targetDir = path.join(home, '.claude', 'agents');
@@ -345,12 +357,12 @@ function deliverGlobalProviderAdapters({ llmChoice, home, commandsDir, testHooks
       written.claude.push(file);
     }
     const skillsRoot = path.join(home, '.claude', 'skills');
-    for (const skillId of GLOBAL_PROVIDER_SKILL_IDS) {
+    for (const skillId of providerSkillIds) {
       const skillPath = path.join(skillsRoot, skillId, 'SKILL.md');
-      if (writeGlobalSkillIfManaged(skillPath, renderGlobalSkill(skillId), home, { beforePublish: testHooks.beforeSkillPublish })) {
+      if (writeGlobalSkillIfManaged(skillPath, renderGlobalSkill(skillId, reactBitsSkillContent), home, { beforePublish: testHooks.beforeSkillPublish })) {
         written.claudeSkills.push(skillId);
       }
-      if (isValidGlobalSkill(skillId, skillPath)) written.claudeAvailableSkills.push(skillId);
+      if (isValidGlobalSkill(skillId, skillPath, reactBitsSkillContent)) written.claudeAvailableSkills.push(skillId);
     }
   }
   if (llmChoice === 'codex' || llmChoice === 'both') {
@@ -373,13 +385,13 @@ function deliverGlobalProviderAdapters({ llmChoice, home, commandsDir, testHooks
       written.codex.push(tomlName);
     }
     const skillsRoot = path.join(home, '.agents', 'skills');
-    for (const skillId of GLOBAL_PROVIDER_SKILL_IDS) {
+    for (const skillId of providerSkillIds) {
       const skillDir = path.join(skillsRoot, skillId);
       const skillPath = path.join(skillDir, 'SKILL.md');
-      if (writeGlobalSkillIfManaged(skillPath, renderGlobalSkill(skillId), home, { beforePublish: testHooks.beforeSkillPublish })) {
+      if (writeGlobalSkillIfManaged(skillPath, renderGlobalSkill(skillId, reactBitsSkillContent), home, { beforePublish: testHooks.beforeSkillPublish })) {
         written.skills.push(skillId);
       }
-      if (isValidGlobalSkill(skillId, skillPath)) written.availableSkills.push(skillId);
+      if (isValidGlobalSkill(skillId, skillPath, reactBitsSkillContent)) written.availableSkills.push(skillId);
     }
   }
   return written;

package/bin/lib/provider-contract.js

@@ -13,6 +13,7 @@ const GLOBAL_PROVIDER_SKILL_IDS = Object.freeze([
   SUPREME_ORCHESTRATOR_ID,
   'sinapse-agent',
 ]);
+const GLOBAL_SUPPLEMENTAL_PROVIDER_SKILL_IDS = Object.freeze(['react-bits-frontend']);
 
 module.exports = {
   CANONICAL_AGENT_COUNT,
@@ -20,4 +21,5 @@ module.exports = {
   SUPREME_PUBLIC_ID,
   MASTER_ALIAS_ENTRY_POINTS,
   GLOBAL_PROVIDER_SKILL_IDS,
+  GLOBAL_SUPPLEMENTAL_PROVIDER_SKILL_IDS,
 };

package/bin/lib/provider-parity.js

@@ -3,8 +3,14 @@
 const {
   CANONICAL_AGENT_COUNT,
   GLOBAL_PROVIDER_SKILL_IDS,
+  GLOBAL_SUPPLEMENTAL_PROVIDER_SKILL_IDS,
 } = require('./provider-contract');
 
+const REQUIRED_GLOBAL_PROVIDER_SKILL_IDS = Object.freeze([
+  ...GLOBAL_PROVIDER_SKILL_IDS,
+  ...GLOBAL_SUPPLEMENTAL_PROVIDER_SKILL_IDS,
+]);
+
 function normalizeCanonicalCatalog(canonicalCatalog, extension) {
   if (!canonicalCatalog || typeof canonicalCatalog === 'number') {
     throw new Error('Provider adapter parity requires the canonical agent ID catalog');
@@ -55,14 +61,14 @@ function assertProviderAdapterParity(llmChoice, adapters, canonicalCatalog) {
   if (llmChoice === 'claude-code' || llmChoice === 'both') {
     problems.push(...describeCatalogDivergence('Claude Code', adapters.claude, claudeCatalog));
     const claudeSkills = new Set(adapters.claudeAvailableSkills || adapters.claudeSkills || []);
-    const missingAliases = GLOBAL_PROVIDER_SKILL_IDS.filter((alias) => !claudeSkills.has(alias));
-    if (missingAliases.length) problems.push(`Claude Code alias skills missing: ${missingAliases.join(', ')}`);
+    const missingSkills = REQUIRED_GLOBAL_PROVIDER_SKILL_IDS.filter((skillId) => !claudeSkills.has(skillId));
+    if (missingSkills.length) problems.push(`Claude Code global skills missing: ${missingSkills.join(', ')}`);
   }
   if (llmChoice === 'codex' || llmChoice === 'both') {
     problems.push(...describeCatalogDivergence('Codex', adapters.codex, codexCatalog));
     const codexSkills = new Set(adapters.availableSkills || adapters.skills || []);
-    const missingAliases = GLOBAL_PROVIDER_SKILL_IDS.filter((alias) => !codexSkills.has(alias));
-    if (missingAliases.length) problems.push(`Codex alias skills missing: ${missingAliases.join(', ')}`);
+    const missingSkills = REQUIRED_GLOBAL_PROVIDER_SKILL_IDS.filter((skillId) => !codexSkills.has(skillId));
+    if (missingSkills.length) problems.push(`Codex global skills missing: ${missingSkills.join(', ')}`);
   }
   if (problems.length) {
     throw new Error(`Provider adapter parity failed (${problems.join('; ')})`);
@@ -70,4 +76,4 @@ function assertProviderAdapterParity(llmChoice, adapters, canonicalCatalog) {
   return claudeCatalog.count;
 }
 
-module.exports = { assertProviderAdapterParity };
+module.exports = { assertProviderAdapterParity, REQUIRED_GLOBAL_PROVIDER_SKILL_IDS };

package/docs/guides/ide-integration.md

@@ -32,7 +32,7 @@ Both providers expose native lifecycle surfaces. Their registration models diffe
 | Measured surface | Claude Code | Codex CLI |
 | --- | --- | --- |
 | Native agents | 172 | 172 |
-| Installed skills | 36 | 37 |
+| Installed skills | 37 | 37 |
 | Registered hooks | 20 native registrations | 9 lifecycle events through the bridge |
 | Activation | `@agent-name` | `$snps` or `$sinapse-agent <id>` |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sinapse-ai",
-  "version": "1.25.3",
+  "version": "1.26.0",
   "description": "SINAPSE AI: Framework de orquestracao de IA — 17 squads, 172 agentes especializados",
   "bin": {
     "sinapse": "bin/sinapse.js",

package/packages/installer/src/installer/react-bits-corpus.js

@@ -0,0 +1,90 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const REACT_BITS_CORPUS_RELATIVE_PATH = path.join('docs', 'framework', 'react-bits');
+const REACT_BITS_SKILL_RELATIVE_PATH = path.join('.agents', 'skills', 'react-bits-frontend', 'SKILL.md');
+const REQUIRED_REACT_BITS_CORPUS_FILES = Object.freeze([
+  'animations.md',
+  'audit-findings.md',
+  'backgrounds.md',
+  'catalog-summary.json',
+  'components.md',
+  'implementation-playbook.md',
+  'index.md',
+  'inventory.json',
+  'text-animations.md',
+]);
+
+function isRegularFile(filePath) {
+  try {
+    return fs.lstatSync(filePath).isFile();
+  } catch (error) {
+    if (error.code === 'ENOENT') return false;
+    throw error;
+  }
+}
+
+function listFilesRecursively(directory, root = directory) {
+  if (!fs.existsSync(directory)) return [];
+  return fs.readdirSync(directory, { withFileTypes: true }).flatMap((entry) => {
+    const sourcePath = path.join(directory, entry.name);
+    if (entry.isDirectory()) return listFilesRecursively(sourcePath, root);
+    return isRegularFile(sourcePath) ? [path.relative(root, sourcePath)] : [];
+  });
+}
+
+function getMissingReactBitsCorpusFiles(root) {
+  return REQUIRED_REACT_BITS_CORPUS_FILES.filter((file) => !isRegularFile(
+    path.join(root, REACT_BITS_CORPUS_RELATIVE_PATH, file),
+  ));
+}
+
+/**
+ * Copy only the shipped React Bits corpus. Existing destination-only files are
+ * intentionally left untouched so a project or global installation never
+ * deletes user research alongside the managed corpus.
+ */
+function copyReactBitsCorpusSync(sourceRoot, destinationRoot) {
+  const source = path.join(sourceRoot, REACT_BITS_CORPUS_RELATIVE_PATH);
+  const destination = path.join(destinationRoot, REACT_BITS_CORPUS_RELATIVE_PATH);
+  const missingFiles = getMissingReactBitsCorpusFiles(sourceRoot);
+  if (missingFiles.length > 0) {
+    throw new Error(`Incomplete React Bits corpus source: ${missingFiles.join(', ')}`);
+  }
+  const files = listFilesRecursively(source);
+  for (const relativePath of files) {
+    const target = path.join(destination, relativePath);
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    fs.copyFileSync(path.join(source, relativePath), target);
+  }
+  return files.map((relativePath) => path.join(REACT_BITS_CORPUS_RELATIVE_PATH, relativePath));
+}
+
+function hasCompleteReactBitsCorpus(root) {
+  return getMissingReactBitsCorpusFiles(root).length === 0;
+}
+
+/** Copy the corpus plus its canonical skill into a global SINAPSE home. */
+function copyReactBitsCapabilitySync(sourceRoot, destinationRoot) {
+  const files = copyReactBitsCorpusSync(sourceRoot, destinationRoot);
+  const sourceSkill = path.join(sourceRoot, REACT_BITS_SKILL_RELATIVE_PATH);
+  const destinationSkill = path.join(destinationRoot, REACT_BITS_SKILL_RELATIVE_PATH);
+  if (!fs.existsSync(sourceSkill)) throw new Error(`Missing React Bits skill: ${sourceSkill}`);
+  fs.mkdirSync(path.dirname(destinationSkill), { recursive: true });
+  fs.copyFileSync(sourceSkill, destinationSkill);
+  return { files, skillPath: destinationSkill };
+}
+
+module.exports = {
+  REACT_BITS_CORPUS_RELATIVE_PATH,
+  REACT_BITS_SKILL_RELATIVE_PATH,
+  REQUIRED_REACT_BITS_CORPUS_FILES,
+  isRegularFile,
+  listFilesRecursively,
+  getMissingReactBitsCorpusFiles,
+  copyReactBitsCorpusSync,
+  copyReactBitsCapabilitySync,
+  hasCompleteReactBitsCorpus,
+};

package/packages/installer/src/installer/sinapse-ai-installer.js

@@ -14,6 +14,7 @@ const path = require('path');
 const crypto = require('crypto');
 const ora = require('ora');
 const { hashFile } = require('./file-hasher');
+const { copyReactBitsCorpusSync } = require('./react-bits-corpus');
 
 const NOFOLLOW_READ_FLAGS = nativeFs.constants.O_RDONLY | (nativeFs.constants.O_NOFOLLOW || 0);
 
@@ -705,6 +706,13 @@ async function installSinapseCore(options = {}) {
       if (claudeSettings) result.installedFiles.push(claudeSettings);
     }
 
+    if (includeClaude || includeCodex) {
+      spinner.text = 'Copying React Bits corpus...';
+      const corpusFiles = copyReactBitsCorpusSync(pkgRoot, targetDir);
+      result.reactBitsCorpusFiles = corpusFiles.length;
+      result.installedFiles.push(...corpusFiles);
+    }
+
     // AGENTS.md is the Codex CLI's default context file (Imperator greeting +
     // the full agent roster). It lives at the package ROOT (not under .codex/ or
     // .sinapse-ai/), so neither loop above reaches it. Without it, a Codex user's
@@ -878,6 +886,7 @@ module.exports = {
   deliverClaudeNativeAdapters,
   getClaudeHookName,
   reconcileClaudeHookSettings,
+  copyReactBitsCorpusSync,
   FOLDERS_TO_COPY,
   ROOT_FILES_TO_COPY,
   CODEX_ROOT_FILES,

package/scripts/sync-provider-adapters.js

@@ -11,10 +11,12 @@ const {
   syncCodexNativeAgents,
 } = require('../.codex/scripts/sync-codex-native');
 const { resolveCodexAgent } = require('../.codex/scripts/resolve-codex-agent');
+const { GLOBAL_SUPPLEMENTAL_PROVIDER_SKILL_IDS } = require('../bin/lib/provider-contract');
 
 const PROJECT_ROOT = path.resolve(__dirname, '..');
 const CLAUDE_AGENTS_DIR = '.claude/agents';
 const CLAUDE_SKILLS_DIR = '.claude/skills';
+const SUPPLEMENTAL_PROVIDER_SKILL_IDS = GLOBAL_SUPPLEMENTAL_PROVIDER_SKILL_IDS;
 
 function writeFileAtomically(filePath, content) {
   const temporaryPath = `${filePath}.${process.pid}.${Date.now()}.tmp`;
@@ -136,11 +138,13 @@ function collectClaudeSkills(projectRoot = PROJECT_ROOT) {
     catalog.genericAgentSkillId,
   ])].sort();
 
-  return skillIds.map((skillId) => {
+  return [...new Set([...skillIds, ...SUPPLEMENTAL_PROVIDER_SKILL_IDS])].sort().map((skillId) => {
     const nativePath = path.join(projectRoot, '.agents', 'skills', skillId, 'SKILL.md');
     const metadata = parseSkillMetadata(fs.readFileSync(nativePath, 'utf8'));
     let content;
-    if (skillId === catalog.genericAgentSkillId) {
+    if (SUPPLEMENTAL_PROVIDER_SKILL_IDS.includes(skillId)) {
+      content = fs.readFileSync(nativePath, 'utf8');
+    } else if (skillId === catalog.genericAgentSkillId) {
       content = renderClaudeGenericSkill(skillId, metadata.description);
     } else if (skillId === 'sinapse-loop' || skillId === 'sinapse-spec-driven') {
       content = renderClaudeWorkflowSkill(skillId, metadata.description);
@@ -195,6 +199,7 @@ if (require.main === module) main();
 module.exports = {
   CLAUDE_AGENTS_DIR,
   CLAUDE_SKILLS_DIR,
+  SUPPLEMENTAL_PROVIDER_SKILL_IDS,
   claudeAgentFileName,
   renderClaudeAgent,
   collectClaudeSkills,

package/scripts/validate-provider-adapters.js

@@ -8,6 +8,11 @@ const yaml = require('js-yaml');
 const legacyClaudeCommandHashes = require('../packages/installer/src/migrations/legacy-claude-agent-command-hashes.json');
 
 const { validateNativeCodex } = require('../.codex/scripts/validate-codex-native');
+const {
+  REACT_BITS_CORPUS_RELATIVE_PATH,
+  REQUIRED_REACT_BITS_CORPUS_FILES,
+  hasCompleteReactBitsCorpus,
+} = require('../packages/installer/src/installer/react-bits-corpus');
 
 const PROJECT_ROOT = path.resolve(__dirname, '..');
 
@@ -125,10 +130,13 @@ function validateClaudeNative(projectRoot = PROJECT_ROOT) {
   try {
     const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
     expectedSkills = (manifest.skillIds || []).map((skillId) => ({ skillId }));
-    if (expectedSkills.length !== 36) errors.push(`Claude skill manifest must contain 36 IDs, found ${expectedSkills.length}`);
+    if (expectedSkills.length !== 37) errors.push(`Claude skill manifest must contain 37 IDs, found ${expectedSkills.length}`);
     for (const alias of ['sinapse', 'sinapse-orqx', 'snps', 'snps-orqx', 'sinapse-agent']) {
       if (!manifest.skillIds.includes(alias)) errors.push(`Claude skill manifest is missing public alias ${alias}`);
     }
+    if (!manifest.skillIds.includes('react-bits-frontend')) {
+      errors.push('Claude skill manifest is missing react-bits-frontend');
+    }
   } catch (error) {
     errors.push(`Claude skill manifest: ${error.message}`);
   }
@@ -209,6 +217,17 @@ function validateProviderAdapters(projectRoot = PROJECT_ROOT) {
     if (!pkg.files.includes(entry)) errors.push(`package.json files[] is missing ${entry}`);
   }
   if (pkg.files.includes('.codex/skills/')) errors.push('package.json must not publish the legacy .codex/skills root');
+  if (!hasCompleteReactBitsCorpus(projectRoot)) {
+    errors.push(`React Bits corpus is incomplete: expected ${REQUIRED_REACT_BITS_CORPUS_FILES.length} files under ${REACT_BITS_CORPUS_RELATIVE_PATH}`);
+  }
+  for (const relativePath of [
+    path.join('.agents', 'skills', 'react-bits-frontend', 'SKILL.md'),
+    path.join('.claude', 'skills', 'react-bits-frontend', 'SKILL.md'),
+  ]) {
+    if (!fs.existsSync(path.join(projectRoot, relativePath))) {
+      errors.push(`React Bits provider skill is missing: ${relativePath}`);
+    }
+  }
   return {
     ok: errors.length === 0,
     errors,
@@ -240,4 +259,5 @@ module.exports = {
   validateClaudeHookSettings,
   validateClaudeNative,
   validateProviderAdapters,
+  REQUIRED_REACT_BITS_CORPUS_FILES,
 };

package/squads/squad-animations/agents/animations-orqx.md

@@ -28,6 +28,8 @@ Kinetic e o diretor da squad. Recebe os Animation Briefs do Decoder (animation-i
 - Garantir coesao entre animacoes de diferentes agentes
 - Orquestrar o workflow prompt-to-animation-cycle
 - Gerar relatorios de entrega
+- Roteiar trabalho React Bits pelo task `orchestrate-react-bits-frontend` e pelo
+  corpus operacional antes de delegar implementacao
 
 ## Pipeline de Orquestracao
 
@@ -64,6 +66,7 @@ Kinetic → Review final → Entrega
 | Hover effects | css-motion-artist | shader-artist |
 | Loading animations | css-motion-artist | motion-choreographer |
 | Camera movements 3D | threejs-architect | motion-choreographer |
+| React Bits frontend | orchestrate-react-bits-frontend | animation-performance-engineer |
 
 ## Criterios de Qualidade
 
@@ -86,6 +89,7 @@ Toda animacao deve passar por:
 | Definir timing e coreografia | motion-choreographer (Tempo) |
 | Implementar scroll animation | scroll-narrative-engineer (Parallax) |
 | Criar sistema de particulas | generative-particle-engineer (Cloud) |
+| Orquestrar frontend React Bits | orchestrate-react-bits-frontend |
 | Otimizar performance | animation-performance-engineer (Benchmark) |
 
 ## NON-NEGOTIABLE: ORCHESTRATE, DON'T EXECUTE
@@ -135,6 +139,9 @@ integration:
     - agent: "animation-performance-engineer (Benchmark)"
       when: "Quality gate before delivery — perf audit, 60fps validation, mobile check"
       context_passed: "all built animations, target devices, perf budget"
+    - agent: "orchestrate-react-bits-frontend"
+      when: "Frontend request that needs React Bits discovery, selection, installation or implementation"
+      context_passed: "project stack, target surface, desired interaction, accessibility and performance constraints"
   receives_from:
     - agent: "@sinapse-orqx (Imperator)"
       when: "Animation/motion request routed from ecosystem"

package/squads/squad-animations/squad.yaml

@@ -23,7 +23,7 @@ metadata:
   total_files: 116
   agents: 9
   tasks: 76
-  workflows: 0
+  workflows: 5
   knowledge_bases: 16
   checklists: 3
   templates: 5