sinapse-ai 1.7.0 → 1.9.0

package/.sinapse-ai/core/health-check/checks/project/framework-config.js

@@ -45,7 +45,7 @@ class FrameworkConfigCheck extends BaseCheck {
       severity: CheckSeverity.HIGH,
       timeout: 3000,
       cacheable: true,
-      healingTier: 0, // Cannot auto-fix framework setup
+      healingTier: 1, // Can auto-create .sinapse local config dir
       tags: ['sinapse', 'config', 'framework'],
     });
   }
@@ -111,7 +111,9 @@ class FrameworkConfigCheck extends BaseCheck {
     if (missingRecommended.length > 0) {
       const missing = missingRecommended.map((c) => c.path).join(', ');
       return this.warning(`Missing recommended configuration: ${missing}`, {
-        recommendation: 'Consider adding recommended configuration for full SINAPSE functionality',
+        recommendation: 'Run health check with --fix to create missing recommended configuration',
+        healable: true,
+        healingTier: 1,
         details: {
           missingRecommended: missingRecommended.map((c) => ({
             path: c.path,
@@ -126,6 +128,40 @@ class FrameworkConfigCheck extends BaseCheck {
       details: { found: found.map((c) => c.path) },
     });
   }
+
+  /**
+   * Get healer for this check
+   * @returns {Object} Healer configuration
+   */
+  getHealer() {
+    return {
+      name: 'create-sinapse-local-config',
+      action: 'create-config',
+      successMessage: 'Created .sinapse local configuration directory',
+      fix: async (_result) => {
+        const projectRoot = process.cwd();
+        const sinapseDir = path.join(projectRoot, '.sinapse');
+
+        await fs.mkdir(sinapseDir, { recursive: true });
+
+        const configPath = path.join(sinapseDir, 'config.yaml');
+        try {
+          await fs.access(configPath);
+        } catch {
+          // Create minimal config stub if it doesn't exist
+          const stub = [
+            '# SINAPSE local configuration',
+            '# Generated by SINAPSE Health Check auto-heal',
+            'permissions:',
+            '  mode: ask',
+          ].join('\n') + '\n';
+          await fs.writeFile(configPath, stub, 'utf8');
+        }
+
+        return { success: true, message: 'Created .sinapse/config.yaml' };
+      },
+    };
+  }
 }
 
 module.exports = FrameworkConfigCheck;

package/.sinapse-ai/core/health-check/checks/project/package-json.js

@@ -28,7 +28,7 @@ class PackageJsonCheck extends BaseCheck {
       severity: CheckSeverity.CRITICAL,
       timeout: 2000,
       cacheable: true,
-      healingTier: 0, // Cannot auto-fix missing/invalid package.json
+      healingTier: 1, // Can auto-patch cosmetic fields (name/version stubs) when JSON is valid
       tags: ['npm', 'config', 'required'],
     });
   }
@@ -70,8 +70,10 @@ class PackageJsonCheck extends BaseCheck {
 
       if (issues.length > 0) {
         return this.warning(`package.json has issues: ${issues.join(', ')}`, {
-          recommendation: 'Fix the package.json fields to match npm requirements',
-          details: { issues, path: packagePath },
+          recommendation: 'Run health check with --fix to patch missing fields',
+          healable: true,
+          healingTier: 1,
+          details: { issues, path: packagePath, packagePath },
         });
       }
 
@@ -100,6 +102,48 @@ class PackageJsonCheck extends BaseCheck {
       return this.error(`Failed to read package.json: ${error.message}`, error);
     }
   }
+
+  /**
+   * Get healer for this check
+   * Patches stub name/version fields when JSON is valid but incomplete
+   * @returns {Object} Healer configuration
+   */
+  getHealer() {
+    return {
+      name: 'patch-package-json-fields',
+      action: 'patch-fields',
+      successMessage: 'Patched missing package.json fields with safe defaults',
+      targetFile: 'package.json',
+      fix: async (_result) => {
+        const projectRoot = process.cwd();
+        const packagePath = path.join(projectRoot, 'package.json');
+
+        const content = await fs.readFile(packagePath, 'utf8');
+        const packageJson = JSON.parse(content);
+
+        let patched = false;
+
+        if (!packageJson.name) {
+          packageJson.name = path.basename(projectRoot).toLowerCase().replace(/[^a-z0-9-]/g, '-');
+          patched = true;
+        }
+
+        if (!packageJson.version) {
+          packageJson.version = '0.1.0';
+          patched = true;
+        }
+
+        if (patched) {
+          await fs.writeFile(packagePath, JSON.stringify(packageJson, null, 2) + '\n', 'utf8');
+        }
+
+        return {
+          success: true,
+          message: patched ? 'Patched package.json with stub fields' : 'No patches needed',
+        };
+      },
+    };
+  }
 }
 
 module.exports = PackageJsonCheck;

package/.sinapse-ai/core/health-check/checks/services/gemini-cli.js

@@ -0,0 +1,117 @@
+/**
+ * Gemini CLI Check
+ *
+ * Verifies Gemini CLI installation and configuration.
+ *
+ * @module sinapse-ai/health-check/checks/services/gemini-cli
+ * @version 1.0.0
+ * @story 5.1 - IDE Sync Expansion
+ */
+
+const fs = require('fs').promises;
+const path = require('path');
+const { execSync } = require('child_process');
+const { BaseCheck, CheckSeverity, CheckDomain } = require('../../base-check');
+
+/**
+ * Gemini CLI check
+ *
+ * @class GeminiCliCheck
+ * @extends BaseCheck
+ */
+class GeminiCliCheck extends BaseCheck {
+  constructor() {
+    super({
+      id: 'services.gemini-cli',
+      name: 'Gemini CLI',
+      description: 'Verifies Gemini CLI installation and configuration',
+      domain: CheckDomain.SERVICES,
+      severity: CheckSeverity.LOW,
+      timeout: 3000,
+      cacheable: true,
+      healingTier: 0,
+      tags: ['gemini', 'google', 'ai', 'cli'],
+    });
+  }
+
+  /**
+   * Execute the check
+   * @param {Object} context - Execution context
+   * @returns {Promise<Object>} Check result
+   */
+  async execute(context) {
+    const projectRoot = context.projectRoot || process.cwd();
+
+    const details = {
+      installed: false,
+      version: null,
+      projectConfig: false,
+      commandsDir: false,
+    };
+
+    // Check if gemini CLI is installed
+    try {
+      const version = execSync('gemini --version', {
+        encoding: 'utf8',
+        timeout: 5000,
+        windowsHide: true,
+      }).trim();
+
+      details.installed = true;
+      details.version = version;
+    } catch {
+      // Not installed - check project config anyway
+    }
+
+    // Check project .gemini directory
+    try {
+      const geminiDir = path.join(projectRoot, '.gemini');
+      await fs.access(geminiDir);
+      details.projectConfig = true;
+
+      // Check for .gemini/commands directory (synced by ide-sync)
+      try {
+        await fs.access(path.join(geminiDir, 'commands'));
+        details.commandsDir = true;
+      } catch {
+        details.commandsDir = false;
+      }
+    } catch {
+      // No project config
+    }
+
+    // Not using Gemini at all → pass silently
+    if (!details.installed && !details.projectConfig) {
+      return this.pass('Gemini CLI not detected (not using Gemini CLI)', {
+        details,
+      });
+    }
+
+    const issues = [];
+
+    if (!details.projectConfig) {
+      issues.push('No .gemini directory found');
+    }
+
+    if (details.projectConfig && !details.commandsDir) {
+      issues.push('.gemini/commands directory missing');
+    }
+
+    if (issues.length > 0) {
+      return this.warning(`Gemini CLI configuration incomplete: ${issues.join(', ')}`, {
+        recommendation: 'Run: npm run sync:ide to generate Gemini command files',
+        details: { ...details, issues },
+      });
+    }
+
+    const parts = [];
+    if (details.installed) parts.push(`CLI ${details.version}`);
+    if (details.commandsDir) parts.push('.gemini/commands synced');
+
+    return this.pass(`Gemini CLI configured (${parts.join(', ')})`, {
+      details,
+    });
+  }
+}
+
+module.exports = GeminiCliCheck;

package/.sinapse-ai/core/health-check/checks/services/index.js

@@ -13,6 +13,7 @@ const McpIntegrationCheck = require('./mcp-integration');
 const GithubCliCheck = require('./github-cli');
 const ClaudeCodeCheck = require('./claude-code');
 const ApiEndpointsCheck = require('./api-endpoints');
+const GeminiCliCheck = require('./gemini-cli');
 
 /**
  * All services domain checks
@@ -22,5 +23,6 @@ module.exports = {
   GithubCliCheck,
   ClaudeCodeCheck,
   ApiEndpointsCheck,
+  GeminiCliCheck,
 };
 

package/.sinapse-ai/core/health-check/healers/index.js

@@ -291,12 +291,49 @@ class HealerManager {
   }
 
   /**
-   * Register built-in healers
+   * Register built-in Tier-1 (Silent) healers.
+   *
+   * Each healer is sourced from its check class via `getHealer()` so the
+   * fix logic lives beside the detection logic — single source of truth.
+   *
+   * Caller: `HealthCheck.run({ autoFix: true, autoFixTier: 1 })` →
+   *         `this.healers.applyFixes(checkResults, 1)` (index.js line 112)
+   *
    * @private
    */
   registerBuiltInHealers() {
-    // Healers will be registered by individual checks
-    // This is a placeholder for future built-in healers
+    // Lazy-require to avoid circular deps at module load time
+    const builtIns = [
+      {
+        id: 'project.sinapse-directory',
+        module: '../checks/project/sinapse-directory',
+      },
+      {
+        id: 'project.framework-config',
+        module: '../checks/project/framework-config',
+      },
+      {
+        id: 'project.package-json',
+        module: '../checks/project/package-json',
+      },
+      {
+        id: 'repository.gitignore',
+        module: '../checks/repository/gitignore',
+      },
+    ];
+
+    for (const { id, module: modulePath } of builtIns) {
+      try {
+        const CheckClass = require(modulePath);
+        const instance = new CheckClass();
+        const healer = instance.getHealer && instance.getHealer();
+        if (healer && typeof healer.fix === 'function') {
+          this.registerHealer(id, healer);
+        }
+      } catch (_err) {
+        // Graceful degradation — missing check module never blocks startup
+      }
+    }
   }
 
   /**