sinapse-ai 7.0.5 → 7.2.0

package/.sinapse-ai/infrastructure/scripts/ide-sync/transformers/github-copilot.js

@@ -1,184 +0,0 @@
-/**
- * GitHub Copilot Transformer - YAML frontmatter + condensed markdown
- * @story 6.19 - IDE Command Auto-Sync System
- * @issue #138 - Agent files not compatible with GitHub Copilot
- *
- * Format: .agent.md files with YAML frontmatter (--- delimiters)
- * Target: .github/agents/*.agent.md
- *
- * GitHub Copilot custom agents require:
- * - YAML frontmatter with `description` (required), `name`, `tools`
- * - Markdown body under 30,000 characters
- * - File extension: .agent.md
- *
- * @see https://docs.github.com/en/copilot/reference/custom-agents-configuration
- */
-
-const { normalizeCommands, getVisibleCommands } = require('../agent-parser');
-
-/**
- * Transform agent data to GitHub Copilot custom agent format
- * @param {object} agentData - Parsed agent data from agent-parser
- * @returns {string} - Transformed content with YAML frontmatter
- */
-function transform(agentData) {
-  const agent = agentData.agent || {};
-  const persona = agentData.persona_profile || {};
-  const yamlData = agentData.yaml || {};
-  const personaBlock = yamlData.persona || {};
-
-  const id = agent.id || agentData.id;
-  const name = agent.name || id;
-  const title = agent.title || 'SINAPSE Agent';
-  const icon = agent.icon || '';
-  const description = escapeYamlString(agent.whenToUse || `${title} agent for development tasks`);
-
-  // Build YAML frontmatter
-  const frontmatter = [
-    '---',
-    `name: ${id}`,
-    `description: '${description}'`,
-    `tools: ['read', 'edit', 'search', 'execute']`,
-    '---',
-  ].join('\n');
-
-  // Build markdown body
-  const body = buildMarkdownBody({
-    id,
-    name,
-    title,
-    icon,
-    personaBlock,
-    persona,
-    commands: agentData.commands || [],
-    sections: agentData.sections || {},
-    corePrinciples: yamlData.core_principles,
-    filename: agentData.filename,
-  });
-
-  const content = `${frontmatter}\n\n${body}`;
-
-  // Enforce 30K character limit
-  if (content.length > 30000) {
-    return truncateContent(content, 30000);
-  }
-
-  return content;
-}
-
-/**
- * Build the markdown body for the Copilot agent prompt
- * @param {object} params - Agent parameters
- * @returns {string} - Markdown body
- */
-function buildMarkdownBody(params) {
-  const { id, name, title, icon, personaBlock, persona, commands, sections, filename } = params;
-
-  const parts = [];
-
-  // Header
-  const headerIcon = icon ? `${icon} ` : '';
-  parts.push(`# ${headerIcon}${name} Agent (@${id})\n`);
-
-  // Role description
-  if (personaBlock.role) {
-    parts.push(`You are an expert ${personaBlock.role}.\n`);
-  } else {
-    parts.push(`You are an expert ${title}.\n`);
-  }
-
-  // Style
-  if (personaBlock.style) {
-    parts.push(`## Style\n\n${personaBlock.style}\n`);
-  }
-
-  // Core principles (may be in persona block or at root level of YAML)
-  const corePrinciples = personaBlock.core_principles || params.corePrinciples;
-  if (corePrinciples && Array.isArray(corePrinciples)) {
-    parts.push('## Core Principles\n');
-    for (const principle of corePrinciples) {
-      // Handle both string and object formats (YAML may parse "KEY: value" as {KEY: value})
-      if (typeof principle === 'string') {
-        parts.push(`- ${principle}`);
-      } else if (typeof principle === 'object' && principle !== null) {
-        const entries = Object.entries(principle);
-        for (const [key, value] of entries) {
-          parts.push(`- ${key}: ${value}`);
-        }
-      }
-    }
-    parts.push('');
-  }
-
-  // Commands reference
-  const allCommands = normalizeCommands(commands);
-  const keyCommands = getVisibleCommands(allCommands, 'key');
-  const quickCommands = getVisibleCommands(allCommands, 'quick');
-  const displayCommands = keyCommands.length > 0 ? keyCommands : quickCommands.slice(0, 10);
-
-  if (displayCommands.length > 0) {
-    parts.push('## Commands\n');
-    parts.push('Use `*` prefix for commands:\n');
-    for (const cmd of displayCommands) {
-      parts.push(`- \`*${cmd.name}\` - ${cmd.description || 'No description'}`);
-    }
-    parts.push('');
-  }
-
-  // Collaboration section (condensed)
-  if (sections.collaboration) {
-    parts.push(`## Collaboration\n\n${sections.collaboration}\n`);
-  }
-
-  // Sync footer
-  parts.push('---');
-  parts.push(`*SINAPSE Agent - Synced from .sinapse-ai/development/agents/${filename}*`);
-  parts.push('');
-
-  return parts.join('\n');
-}
-
-/**
- * Escape a string for use as a YAML single-quoted value
- * Single quotes inside the string must be doubled
- * @param {string} str - Input string
- * @returns {string} - Escaped string
- */
-function escapeYamlString(str) {
-  if (!str) return '';
-  // In YAML single-quoted strings, single quotes are escaped by doubling them
-  return str.replace(/'/g, "''");
-}
-
-/**
- * Truncate content to fit within character limit while keeping structure valid
- * @param {string} content - Full content
- * @param {number} maxChars - Maximum characters
- * @returns {string} - Truncated content
- */
-function truncateContent(content, maxChars) {
-  // Find the last complete section before the limit
-  const truncated = content.substring(0, maxChars - 100);
-  const lastNewline = truncated.lastIndexOf('\n\n');
-
-  if (lastNewline > 0) {
-    return truncated.substring(0, lastNewline) + '\n\n---\n*Content truncated to fit 30K limit*\n';
-  }
-  return truncated + '\n\n---\n*Content truncated to fit 30K limit*\n';
-}
-
-/**
- * Get the target filename for this agent (with .agent.md extension)
- * @param {object} agentData - Parsed agent data
- * @returns {string} - Target filename (e.g., "dev.agent.md")
- */
-function getFilename(agentData) {
-  const id = (agentData.agent && agentData.agent.id) || agentData.id;
-  return `${id}.agent.md`;
-}
-
-module.exports = {
-  transform,
-  getFilename,
-  format: 'github-copilot',
-};

package/.sinapse-ai/infrastructure/scripts/validate-gemini-integration.js

@@ -1,151 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-
-function getDefaultOptions() {
-  const projectRoot = process.cwd();
-  return {
-    projectRoot,
-    rulesFile: path.join(projectRoot, '.gemini', 'rules.md'),
-    agentsDir: path.join(projectRoot, '.gemini', 'rules', 'SINAPSE', 'agents'),
-    commandsDir: path.join(projectRoot, '.gemini', 'commands'),
-    extensionDir: path.join(projectRoot, 'packages', 'gemini-sinapse-extension'),
-    sourceAgentsDir: path.join(projectRoot, '.sinapse-ai', 'development', 'agents'),
-    quiet: false,
-    json: false,
-  };
-}
-
-function parseArgs(argv = process.argv.slice(2)) {
-  const args = new Set(argv);
-  return {
-    quiet: args.has('--quiet') || args.has('-q'),
-    json: args.has('--json'),
-  };
-}
-
-function countMarkdownFiles(dirPath) {
-  if (!fs.existsSync(dirPath)) return 0;
-  return fs.readdirSync(dirPath).filter((f) => f.endsWith('.md')).length;
-}
-
-function validateGeminiIntegration(options = {}) {
-  const projectRoot = options.projectRoot || process.cwd();
-  const resolved = {
-    ...getDefaultOptions(),
-    ...options,
-    projectRoot,
-    rulesFile: options.rulesFile || path.join(projectRoot, '.gemini', 'rules.md'),
-    agentsDir: options.agentsDir || path.join(projectRoot, '.gemini', 'rules', 'SINAPSE', 'agents'),
-    commandsDir: options.commandsDir || path.join(projectRoot, '.gemini', 'commands'),
-    extensionDir: options.extensionDir || path.join(projectRoot, 'packages', 'gemini-sinapse-extension'),
-    sourceAgentsDir: options.sourceAgentsDir || path.join(projectRoot, '.sinapse-ai', 'development', 'agents'),
-  };
-  const errors = [];
-  const warnings = [];
-
-  if (!fs.existsSync(resolved.rulesFile)) {
-    warnings.push(`Gemini rules file not found yet: ${path.relative(resolved.projectRoot, resolved.rulesFile)}`);
-  }
-
-  if (!fs.existsSync(resolved.agentsDir)) {
-    errors.push(`Missing Gemini agents dir: ${path.relative(resolved.projectRoot, resolved.agentsDir)}`);
-  }
-  if (!fs.existsSync(resolved.commandsDir)) {
-    errors.push(`Missing Gemini commands dir: ${path.relative(resolved.projectRoot, resolved.commandsDir)}`);
-  }
-
-  const sourceCount = countMarkdownFiles(resolved.sourceAgentsDir);
-  const geminiCount = countMarkdownFiles(resolved.agentsDir);
-  const commandFiles = fs.existsSync(resolved.commandsDir)
-    ? fs.readdirSync(resolved.commandsDir).filter((f) => f.endsWith('.toml'))
-    : [];
-  const expectedCommandCount = sourceCount > 0 ? sourceCount + 1 : 0;
-
-  if (sourceCount > 0 && commandFiles.length !== expectedCommandCount) {
-    warnings.push(`Gemini command count differs from source (${commandFiles.length}/${expectedCommandCount})`);
-  }
-  if (!commandFiles.includes('sinapse-menu.toml')) {
-    errors.push(`Missing Gemini command file: ${path.relative(resolved.projectRoot, path.join(resolved.commandsDir, 'sinapse-menu.toml'))}`);
-  }
-  if (sourceCount > 0 && geminiCount !== sourceCount) {
-    warnings.push(`Gemini agent count differs from source (${geminiCount}/${sourceCount})`);
-  }
-
-  const requiredExtensionFiles = [
-    'extension.json',
-    'README.md',
-    path.join('commands', 'sinapse-status.js'),
-    path.join('commands', 'sinapse-agents.js'),
-    path.join('commands', 'sinapse-validate.js'),
-    path.join('hooks', 'hooks.json'),
-  ];
-
-  for (const rel of requiredExtensionFiles) {
-    const abs = path.join(resolved.extensionDir, rel);
-    if (!fs.existsSync(abs)) {
-      errors.push(`Missing Gemini extension file: ${path.relative(resolved.projectRoot, abs)}`);
-    }
-  }
-
-  return {
-    ok: errors.length === 0,
-    errors,
-    warnings,
-    metrics: {
-      sourceAgents: sourceCount,
-      geminiAgents: geminiCount,
-      geminiCommands: commandFiles.length,
-    },
-  };
-}
-
-function formatHumanReport(result) {
-  if (result.ok) {
-    const lines = [
-      `✅ Gemini integration validation passed (agents: ${result.metrics.geminiAgents}, commands: ${result.metrics.geminiCommands})`,
-    ];
-    if (result.warnings.length > 0) {
-      lines.push(...result.warnings.map((w) => `⚠️ ${w}`));
-    }
-    return lines.join('\n');
-  }
-  const lines = [
-    `❌ Gemini integration validation failed (${result.errors.length} issue(s))`,
-    ...result.errors.map((e) => `- ${e}`),
-  ];
-  if (result.warnings.length > 0) {
-    lines.push(...result.warnings.map((w) => `⚠️ ${w}`));
-  }
-  return lines.join('\n');
-}
-
-function main() {
-  const args = parseArgs();
-  const result = validateGeminiIntegration(args);
-
-  if (!args.quiet) {
-    if (args.json) {
-      console.log(JSON.stringify(result, null, 2));
-    } else {
-      console.log(formatHumanReport(result));
-    }
-  }
-
-  if (!result.ok) {
-    process.exitCode = 1;
-  }
-}
-
-if (require.main === module) {
-  main();
-}
-
-module.exports = {
-  validateGeminiIntegration,
-  parseArgs,
-  getDefaultOptions,
-  countMarkdownFiles,
-};

package/.sinapse-ai/product/templates/ide-rules/antigravity-rules.md

@@ -1,115 +0,0 @@
-# SINAPSE Development Rules for AntiGravity
-
-You are working with SINAPSE, an AI-Orchestrated System for Full Stack Development.
-
-## Core Development Rules
-
-### Agent Integration
-- Recognize SINAPSE agent activations: @developer, @quality-gate, @architect, @project-lead, @product-lead, @sprint-lead, @analyst
-- Agent commands use * prefix: *help, *create-story, *task, *exit
-- Follow agent-specific workflows and patterns
-
-### Story-Driven Development
-1. **Always work from a story file** in docs/stories/
-2. **Update story checkboxes** as you complete tasks: [ ] → [x]
-3. **Maintain the File List** section with all created/modified files
-4. **Follow acceptance criteria** exactly as written
-
-### Code Quality Standards
-- Write clean, maintainable code following project conventions
-- Include comprehensive error handling
-- Add unit tests for all new functionality
-- Follow existing patterns in the codebase
-
-### Testing Protocol
-- Run all tests before marking tasks complete
-- Ensure linting passes: `npm run lint`
-- Verify type checking: `npm run typecheck`
-- Add tests for new features
-
-## SINAPSE Framework Structure
-
-```
-sinapse-ai/
-├── agents/       # Agent persona definitions
-├── tasks/        # Executable task workflows
-├── workflows/    # Multi-step workflows
-├── templates/    # Document templates
-└── checklists/   # Validation checklists
-
-docs/
-├── stories/      # Development stories
-├── prd/          # Sharded PRD sections
-└── architecture/ # Sharded architecture
-```
-
-## Development Workflow
-
-1. **Read the story** - Understand requirements fully
-2. **Implement sequentially** - Follow task order
-3. **Test thoroughly** - Validate each step
-4. **Update story** - Mark completed items
-5. **Document changes** - Update File List
-
-## Best Practices
-
-### When implementing:
-- Check existing patterns first
-- Reuse components and utilities
-- Follow naming conventions
-- Keep functions focused and small
-
-### When testing:
-- Write tests alongside implementation
-- Test edge cases
-- Verify error handling
-- Run full test suite
-
-### When documenting:
-- Update README for new features
-- Document API changes
-- Add inline comments for complex logic
-- Keep story File List current
-
-## Git & GitHub
-
-- Use conventional commits: `feat:`, `fix:`, `docs:`, etc.
-- Reference story ID in commits: `feat: implement IDE detection [Story 2.1]`
-- Ensure GitHub CLI is configured: `gh auth status`
-- Push regularly to avoid conflicts
-
-## Common Patterns
-
-### Error Handling
-```javascript
-try {
-  // Operation
-} catch (error) {
-  console.error(`Error in ${operation}:`, error);
-  throw new Error(`Failed to ${operation}: ${error.message}`);
-}
-```
-
-### File Operations
-```javascript
-const fs = require('fs-extra');
-const path = require('path');
-
-// Always use absolute paths
-const filePath = path.join(__dirname, 'relative/path');
-```
-
-### Async/Await
-```javascript
-async function operation() {
-  try {
-    const result = await asyncOperation();
-    return result;
-  } catch (error) {
-    // Handle error appropriately
-  }
-}
-```
-
----
-*SINAPSE AntiGravity Configuration v1.0*

package/.sinapse-ai/product/templates/ide-rules/copilot-rules.md

@@ -1,92 +0,0 @@
-# SINAPSE Agent for GitHub Copilot
-
-You are working with SINAPSE, an AI-Orchestrated System for Full Stack Development.
-
-## Core Framework Understanding
-
-SINAPSE is a meta-framework that orchestrates AI agents to handle complex development workflows. Always recognize and work within this architecture.
-
-## Agent System
-
-### Agent Activation (Chat Modes)
-- Select agent mode from the chat mode selector in VS Code
-- Available agents: dev, qa, architect, pm, po, sm, analyst
-- Agent commands use the * prefix: *help, *create-story, *task, *exit
-
-### Agent Context
-When an agent mode is active:
-- Follow that agent's specific persona and expertise
-- Use the agent's designated workflow patterns
-- Maintain the agent's perspective throughout the interaction
-
-## Development Methodology
-
-### Story-Driven Development
-1. **Work from stories** - All development starts with a story in `docs/stories/`
-2. **Update progress** - Mark checkboxes as tasks complete: [ ] → [x]
-3. **Track changes** - Maintain the File List section in the story
-4. **Follow criteria** - Implement exactly what the acceptance criteria specify
-
-### Code Standards
-- Write clean, self-documenting code
-- Follow existing patterns in the codebase
-- Include comprehensive error handling
-- Add unit tests for all new functionality
-- Use TypeScript/JavaScript best practices
-
-### Testing Requirements
-- Run all tests before marking tasks complete
-- Ensure linting passes: `npm run lint`
-- Verify type checking: `npm run typecheck`
-- Add tests for new features
-- Test edge cases and error scenarios
-
-## SINAPSE Framework Structure
-
-```
-sinapse-ai/
-├── agents/         # Agent persona definitions (YAML/Markdown)
-├── tasks/          # Executable task workflows
-├── workflows/      # Multi-step workflow definitions
-├── templates/      # Document and code templates
-├── checklists/     # Validation and review checklists
-└── rules/          # Framework rules and patterns
-
-docs/
-├── stories/        # Development stories (numbered)
-├── prd/            # Product requirement documents
-├── architecture/   # System architecture documentation
-└── guides/         # User and developer guides
-```
-
-## GitHub Copilot-Specific Configuration
-
-### Requirements
-- VS Code 1.101+ required
-- Enable `chat.agent.enabled: true` in settings
-
-### Chat Modes Location
-- Agent modes defined in `.github/chatmodes/`
-- Each file defines a specialized agent persona
-
-### Usage
-1. Open Chat view: `Ctrl+Alt+I` (Windows/Linux) or `⌃⌘I` (Mac)
-2. Select **Agent** from the chat mode selector
-3. Choose the SINAPSE agent mode you need
-
-### Available Agent Modes
-| Mode | Purpose |
-|------|---------|
-| sinapse-dev | Full-stack development |
-| sinapse-qa | Quality assurance |
-| sinapse-architect | System design |
-| sinapse-pm | Project management |
-
-### Performance Tips
-- Use inline completions for quick code suggestions
-- Use chat for complex explanations and refactoring
-- Reference files with @file syntax
-- Use @workspace for project-wide context
-
----
-*SINAPSE GitHub Copilot Configuration v4.0.4*

package/.sinapse-ai/product/templates/ide-rules/cursor-rules.md

@@ -1,115 +0,0 @@
-# SINAPSE Development Rules for Cursor
-
-You are working with SINAPSE, an AI-Orchestrated System for Full Stack Development.
-
-## Core Development Rules
-
-### Agent Integration
-- Recognize SINAPSE agent activations: @developer, @quality-gate, @architect, @project-lead, @product-lead, @sprint-lead, @analyst
-- Agent commands use * prefix: *help, *create-story, *task, *exit
-- Follow agent-specific workflows and patterns
-
-### Story-Driven Development
-1. **Always work from a story file** in docs/stories/
-2. **Update story checkboxes** as you complete tasks: [ ] → [x]
-3. **Maintain the File List** section with all created/modified files
-4. **Follow acceptance criteria** exactly as written
-
-### Code Quality Standards
-- Write clean, maintainable code following project conventions
-- Include comprehensive error handling
-- Add unit tests for all new functionality
-- Follow existing patterns in the codebase
-
-### Testing Protocol
-- Run all tests before marking tasks complete
-- Ensure linting passes: `npm run lint`
-- Verify type checking: `npm run typecheck`
-- Add tests for new features
-
-## SINAPSE Framework Structure
-
-```
-sinapse-ai/
-├── agents/       # Agent persona definitions
-├── tasks/        # Executable task workflows
-├── workflows/    # Multi-step workflows
-├── templates/    # Document templates
-└── checklists/   # Validation checklists
-
-docs/
-├── stories/      # Development stories
-├── prd/          # Sharded PRD sections
-└── architecture/ # Sharded architecture
-```
-
-## Development Workflow
-
-1. **Read the story** - Understand requirements fully
-2. **Implement sequentially** - Follow task order
-3. **Test thoroughly** - Validate each step
-4. **Update story** - Mark completed items
-5. **Document changes** - Update File List
-
-## Best Practices
-
-### When implementing:
-- Check existing patterns first
-- Reuse components and utilities
-- Follow naming conventions
-- Keep functions focused and small
-
-### When testing:
-- Write tests alongside implementation
-- Test edge cases
-- Verify error handling
-- Run full test suite
-
-### When documenting:
-- Update README for new features
-- Document API changes
-- Add inline comments for complex logic
-- Keep story File List current
-
-## Git & GitHub
-
-- Use conventional commits: `feat:`, `fix:`, `docs:`, etc.
-- Reference story ID in commits: `feat: implement IDE detection [Story 2.1]`
-- Ensure GitHub CLI is configured: `gh auth status`
-- Push regularly to avoid conflicts
-
-## Common Patterns
-
-### Error Handling
-```javascript
-try {
-  // Operation
-} catch (error) {
-  console.error(`Error in ${operation}:`, error);
-  throw new Error(`Failed to ${operation}: ${error.message}`);
-}
-```
-
-### File Operations
-```javascript
-const fs = require('fs-extra');
-const path = require('path');
-
-// Always use absolute paths
-const filePath = path.join(__dirname, 'relative/path');
-```
-
-### Async/Await
-```javascript
-async function operation() {
-  try {
-    const result = await asyncOperation();
-    return result;
-  } catch (error) {
-    // Handle error appropriately
-  }
-}
-```
-
----
-*SINAPSE Cursor Configuration v1.0*