devintelligence 1.0.0 → 1.0.1

package/src/engine/aiEngine.test.ts

@@ -1,86 +0,0 @@
-import test from 'node:test';
-import assert from 'node:assert/strict';
-import {
-  diagnoseRawErrorLogWithAi,
-  generateProjectAiAdvice,
-  askDevIntelligenceAi,
-  isAiRateLimited,
-  resetAiRateLimit,
-  callGroqChat,
-} from './aiEngine.ts';
-import { getProjectReportById } from './repairEngine.ts';
-
-test('AI Engine: Successfully analyzes React Native error using Groq AI with rich diagnosis', async () => {
-  const sampleLog = 'Error: Objects are not valid as a React child (found: object with keys {title, id}). If you meant to render a collection of children, use an array instead.';
-  const diag = await diagnoseRawErrorLogWithAi(sampleLog);
-
-  assert.ok(diag.summary);
-  assert.ok(diag.rootCause);
-  assert.ok(diag.confidence >= 50);
-  assert.ok(Array.isArray(diag.safeRepairSteps));
-  assert.ok(diag.safeRepairSteps.length > 0);
-  assert.equal(typeof diag.aiPowered, 'boolean');
-});
-
-test('AI Engine Shield: Guaranteed zero-downtime fallback when quota is exhausted or key is invalid', async () => {
-  const originalKey = process.env.GROQ_API_KEY;
-  try {
-    // Deliberately simulate invalid key / quota exhaustion
-    process.env.GROQ_API_KEY = 'gsk_EXHAUSTED_LIMIT_TEST_KEY_12345';
-    resetAiRateLimit();
-
-    const sampleLog = 'android:exported needs to be explicitly specified for <activity>';
-    const diag = await diagnoseRawErrorLogWithAi(sampleLog);
-
-    assert.equal(diag.aiPowered, false);
-    assert.equal(diag.fallbackUsed, true);
-    assert.ok(diag.fallbackReason?.length);
-    assert.equal(diag.category, 'Android Manifest');
-    assert.ok(diag.summary.includes('Manifest'));
-    assert.ok(diag.safeRepairSteps.length > 0);
-  } finally {
-    process.env.GROQ_API_KEY = originalKey;
-    resetAiRateLimit();
-  }
-});
-
-test('AI Engine Shield: Circuit breaker prevents network spam during rate limit cooldown', async () => {
-  const originalKey = process.env.GROQ_API_KEY;
-  try {
-    process.env.GROQ_API_KEY = 'gsk_TEST_COOLDOWN_KEY';
-    // Simulate active rate-limit cooldown
-    const sampleLog = 'Failed to create a worklet';
-    
-    // Call low level to verify circuit breaker detection
-    const res = await callGroqChat([{ role: 'user', content: 'test' }]);
-    assert.equal(typeof res.ok, 'boolean');
-
-    const diag = await diagnoseRawErrorLogWithAi(sampleLog);
-    assert.equal(typeof diag.aiPowered, 'boolean');
-    assert.ok(diag.summary.includes('Reanimated') || diag.summary.includes('worklet') || diag.summary.includes('Babel'));
-  } finally {
-    process.env.GROQ_API_KEY = originalKey;
-    resetAiRateLimit();
-  }
-});
-
-test('AI Engine: Gracefully handles empty or blank error log without throwing', async () => {
-  const diag = await diagnoseRawErrorLogWithAi('   ');
-  assert.ok(diag.summary);
-  assert.ok(diag.category);
-  assert.equal(diag.aiPowered, undefined); // Returns pure heuristic default
-});
-
-test('AI Engine: Generates project executive advice with fallback support', async () => {
-  const report = getProjectReportById('rn-expo-commerce', false);
-  const advice = await generateProjectAiAdvice(report);
-
-  assert.ok(advice.advice.length > 50);
-  assert.equal(typeof advice.aiPowered, 'boolean');
-});
-
-test('AI Engine: Ask assistant returns meaningful technical answer', async () => {
-  const res = await askDevIntelligenceAi('How to clear Metro bundler cache?');
-  assert.ok(res.answer.includes('start') || res.answer.includes('cache') || res.answer.includes('Metro'));
-  assert.equal(typeof res.aiPowered, 'boolean');
-});

package/src/engine/aiEngine.ts

@@ -1,346 +0,0 @@
-/**
- * DEVINTELLIGENCE & NETCONTROL AI Engine (Powered by Groq)
- *
- * Provides ultra-fast LLM inference with resilient fallback architecture.
- * If the Groq API key reaches rate limits (HTTP 429), quota limits, or network timeouts,
- * this engine automatically and seamlessly falls back to built-in heuristic rule-based engines
- * so that the system NEVER crashes and operations continue 100% normally.
- */
-
-import type { ErrorDiagnosisResult, IssueSeverity, ProjectIntelligenceReport } from '../types/devintelligence.ts';
-import { diagnoseRawErrorLog } from './analyzerEngine.ts';
-
-// Hardcoded fallback key provided by user, overridden by process.env.GROQ_API_KEY
-const DEFAULT_GROQ_KEY = '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';
-const PRIMARY_MODEL = process.env.GROQ_MODEL || 'qwen/qwen3.8-27b';
-const FALLBACK_MODEL = 'openai/gpt-oss-20b';
-
-// In-memory circuit breaker to avoid hammering Groq when rate limits / quota are active
-let rateLimitCooldownUntil = 0;
-let lastRateLimitMessage = '';
-
-export function getGroqApiKey(): string {
-  return process.env.GROQ_API_KEY || DEFAULT_GROQ_KEY;
-}
-
-export function isAiRateLimited(): boolean {
-  return Date.now() < rateLimitCooldownUntil;
-}
-
-export function resetAiRateLimit(): void {
-  rateLimitCooldownUntil = 0;
-  lastRateLimitMessage = '';
-}
-
-interface GroqMessage {
-  role: 'system' | 'user' | 'assistant';
-  content: string;
-}
-
-export interface GroqChatSuccess {
-  ok: true;
-  content: string;
-  model: string;
-}
-
-export interface GroqChatFailure {
-  ok: false;
-  error: string;
-  isRateLimit: boolean;
-}
-
-export type GroqChatResult = GroqChatSuccess | GroqChatFailure;
-
-interface GroqChatOptions {
-  model?: string;
-  temperature?: number;
-  maxTokens?: number;
-  jsonMode?: boolean;
-}
-
-/**
- * Low-level caller for Groq OpenAI-compatible Chat Completions API.
- * Protected by timeout, circuit breaker, and graceful error trapping.
- */
-export async function callGroqChat(
-  messages: GroqMessage[],
-  options: GroqChatOptions = {}
-): Promise<GroqChatResult> {
-  const apiKey = getGroqApiKey();
-  if (!apiKey || !apiKey.startsWith('gsk_')) {
-    return { ok: false, error: 'No valid Groq API key configured', isRateLimit: false };
-  }
-
-  // If in rate-limit cooldown, fail fast to rule fallback
-  if (isAiRateLimited()) {
-    return {
-      ok: false,
-      error: `AI Rate limit cooldown active for ${Math.ceil((rateLimitCooldownUntil - Date.now()) / 1000)}s: ${lastRateLimitMessage}`,
-      isRateLimit: true,
-    };
-  }
-
-  const model = options.model || PRIMARY_MODEL;
-  const controller = new AbortController();
-  const timeoutId = setTimeout(() => controller.abort(), 12000); // 12s safety timeout
-
-  try {
-    const payload: Record<string, unknown> = {
-      model,
-      messages,
-      temperature: options.temperature ?? 0.2,
-      max_tokens: options.maxTokens ?? 1500,
-    };
-
-    if (options.jsonMode) {
-      payload.response_format = { type: 'json_object' };
-    }
-
-    const response = await fetch('https://api.groq.com/openai/v1/chat/completions', {
-      method: 'POST',
-      headers: {
-        'Authorization': `Bearer ${apiKey}`,
-        'Content-Type': 'application/json',
-      },
-      body: JSON.stringify(payload),
-      signal: controller.signal,
-    });
-
-    clearTimeout(timeoutId);
-
-    if (response.status === 429) {
-      const errText = await response.text();
-      // Set 45-second cooldown to protect user quota and prevent latency spikes
-      rateLimitCooldownUntil = Date.now() + 45000;
-      lastRateLimitMessage = 'Groq rate limit or quota exceeded (HTTP 429)';
-      console.warn(`[Groq AI Shield] Rate limit reached (429). Triggered 45s cooldown. Falling back to local rule engine.`);
-      return { ok: false, error: errText, isRateLimit: true };
-    }
-
-    if (!response.ok) {
-      const errText = await response.text();
-      console.warn(`[Groq AI Shield] HTTP error ${response.status}: ${errText}. Falling back to local rule engine.`);
-      return { ok: false, error: `Groq HTTP ${response.status}: ${errText}`, isRateLimit: false };
-    }
-
-    const data = (await response.json()) as any;
-    const content = data.choices?.[0]?.message?.content || '';
-    return { ok: true, content, model };
-  } catch (err: any) {
-    clearTimeout(timeoutId);
-    const isTimeout = err.name === 'AbortError';
-    const errorMsg = isTimeout ? 'AI Request timed out after 12s' : err.message || 'Unknown network error';
-    console.warn(`[Groq AI Shield] Call failed (${errorMsg}). Gracefully falling back to local rule engine.`);
-    return { ok: false, error: errorMsg, isRateLimit: false };
-  }
-}
-
-/**
- * AI-Powered Error Log Diagnosis with Guaranteed Rule Fallback.
- * If AI fails, exceeds quota, or is offline, the local heuristic rule engine
- * automatically generates a complete diagnosis with 0 downtime.
- */
-export async function diagnoseRawErrorLogWithAi(rawLog: string): Promise<ErrorDiagnosisResult> {
-  const fallbackResult = diagnoseRawErrorLog(rawLog);
-
-  if (!rawLog || !rawLog.trim()) {
-    return fallbackResult;
-  }
-
-  const systemPrompt = `You are the lead engineering diagnostic agent in DEVINTELLIGENCE.
-Analyze the provided terminal error trace, Metro bundler failure, Android Gradle/Kotlin error, iOS CocoaPods error, or React Native Red Screen crash.
-Respond ONLY with a valid JSON object matching this TypeScript structure:
-{
-  "category": "Metro Bundler" | "Babel / Reanimated" | "Android Gradle / Kotlin" | "Android Manifest" | "CocoaPods / iOS" | "Native Module Linking" | "Hermes Runtime" | "React Render / Hook Crash" | "Dependency Conflict",
-  "severity": "critical" | "high" | "medium" | "low",
-  "confidence": number (between 70 and 99),
-  "summary": "Short 1-sentence punchy title of the crash",
-  "rootCause": "Detailed technical root-cause explanation of what broke and why",
-  "responsibleFile": "File path most likely responsible (e.g. android/app/build.gradle, babel.config.js, etc.)",
-  "line": number or null,
-  "safeRepairSteps": ["step 1", "step 2", "step 3"],
-  "terminalCommands": ["exact command to run"],
-  "codePatchSuggestion": "exact code or config patch snippet to fix it"
-}`;
-
-  const userPrompt = `Diagnose this error log:\n\n${rawLog.slice(0, 3000)}`;
-
-  try {
-    const aiRes = await callGroqChat(
-      [
-        { role: 'system', content: systemPrompt },
-        { role: 'user', content: userPrompt },
-      ],
-      { jsonMode: true, temperature: 0.1 }
-    );
-
-    if (!aiRes.ok) {
-      const failure = aiRes as GroqChatFailure;
-      return {
-        ...fallbackResult,
-        aiPowered: false,
-        fallbackUsed: true,
-        fallbackReason: failure.isRateLimit
-          ? 'AI rate limit reached. Analysis generated seamlessly by local heuristic rule engine.'
-          : `AI unavailable (${failure.error}). Analysis completed by local heuristic rule engine.`,
-      };
-    }
-
-    try {
-      const parsed = JSON.parse(aiRes.content);
-      return {
-        id: `ai-diag-${Date.now()}`,
-        category: parsed.category || fallbackResult.category,
-        severity: (['critical', 'high', 'medium', 'low'].includes(parsed.severity)
-          ? parsed.severity
-          : fallbackResult.severity) as IssueSeverity,
-        confidence: typeof parsed.confidence === 'number' ? Math.min(Math.max(parsed.confidence, 60), 99) : 95,
-        summary: parsed.summary || fallbackResult.summary,
-        rootCause: parsed.rootCause || fallbackResult.rootCause,
-        responsibleFile: parsed.responsibleFile || fallbackResult.responsibleFile,
-        line: typeof parsed.line === 'number' ? parsed.line : fallbackResult.line,
-        safeRepairSteps: Array.isArray(parsed.safeRepairSteps) && parsed.safeRepairSteps.length > 0
-          ? parsed.safeRepairSteps
-          : fallbackResult.safeRepairSteps,
-        terminalCommands: Array.isArray(parsed.terminalCommands)
-          ? parsed.terminalCommands
-          : fallbackResult.terminalCommands,
-        codePatchSuggestion: parsed.codePatchSuggestion || fallbackResult.codePatchSuggestion,
-        aiPowered: true,
-        aiModel: aiRes.model,
-        fallbackUsed: false,
-      };
-    } catch (parseErr) {
-      console.warn('[Groq AI] JSON parse error in AI diagnosis, falling back to rule engine:', parseErr);
-      return {
-        ...fallbackResult,
-        aiPowered: false,
-        fallbackUsed: true,
-        fallbackReason: 'AI response parse failed. Analysis completed by local heuristic rule engine.',
-      };
-    }
-  } catch (err: any) {
-    return {
-      ...fallbackResult,
-      aiPowered: false,
-      fallbackUsed: true,
-      fallbackReason: `Local rule fallback active: ${err.message || 'AI request interrupted'}`,
-    };
-  }
-}
-
-/**
- * Generates an AI-driven Executive Engineering Brief for a project.
- * Falls back to deterministic rule summary if quota is exhausted.
- */
-export async function generateProjectAiAdvice(
-  report: ProjectIntelligenceReport
-): Promise<{ advice: string; aiPowered: boolean; model?: string }> {
-  const issuesSample = report.issues.slice(0, 8).map((i) => ({
-    title: i.title,
-    severity: i.severity,
-    domain: i.domain,
-    file: `${i.filePath}:${i.line}`,
-    explanation: i.explanation,
-  }));
-
-  const systemPrompt = `You are a Principal Mobile & Fullstack Architect reviewing a code scan report.
-Provide a concise, 3-paragraph executive engineering assessment:
-1. Overall architecture and health overview based on scores and ecosystem.
-2. Immediate critical threats (security, native crashes, memory leaks).
-3. Exact prioritized 3-step action plan to reach 100/100 Quality Gate.
-Keep it strictly technical, direct, and actionable. Do not use generic filler.`;
-
-  const userPrompt = `Project: ${report.name} (${report.ecosystem})
-Scores: Overall: ${report.scores.overall}/100, Security: ${report.scores.security}/100, Performance: ${report.scores.performance}/100, RN: ${report.scores.reactNative}/100
-Issues Count: ${report.issues.length}
-Key Issues:
-${JSON.stringify(issuesSample, null, 2)}`;
-
-  const aiRes = await callGroqChat(
-    [
-      { role: 'system', content: systemPrompt },
-      { role: 'user', content: userPrompt },
-    ],
-    { temperature: 0.3, maxTokens: 800 }
-  );
-
-  if (aiRes.ok && aiRes.content.trim()) {
-    return {
-      advice: aiRes.content.trim(),
-      aiPowered: true,
-      model: aiRes.model,
-    };
-  }
-
-  // Graceful rule-based fallback advice
-  const criticals = report.issues.filter((i) => i.severity === 'critical');
-  const safeRepairs = report.issues.filter((i) => i.repairTier === 'SAFE');
-
-  const fallbackAdvice = `### Deterministic Engineering Assessment (Rule Engine Fallback)
-
-1. **Architecture Status**: Project **${report.name}** is operating on **${report.ecosystem}** with an overall score of **${report.scores.overall}/100**.
-${criticals.length > 0 ? `🚨 **Critical Attention Needed**: Detected ${criticals.length} critical issues including ${criticals.map((c) => c.title).slice(0, 2).join(' and ')}.` : '✅ No critical blocker violations found.'}
-
-2. **Automated Remediation Opportunity**: **${safeRepairs.length} of ${report.issues.length}** detected issues have validated SAFE auto-repair patches ready to apply with zero regression risk.
-
-3. **Recommended 3-Step Action Plan**:
-   - Run safe batch remediation: \`devintelligence fix --project=${report.id}\`
-   - Review security and authentication tokens in \`Security Audit\`
-   - Check bundler cache and verify Quality Gate threshold compliance.`;
-
-  return {
-    advice: fallbackAdvice,
-    aiPowered: false,
-  };
-}
-
-/**
- * General AI Assistant for interactive developer queries or network troubleshooting.
- */
-export async function askDevIntelligenceAi(
-  query: string,
-  contextData?: unknown
-): Promise<{ answer: string; aiPowered: boolean; model?: string }> {
-  if (!query || !query.trim()) {
-    return { answer: 'Please enter a query.', aiPowered: false };
-  }
-
-  const systemPrompt = `You are the DEVINTELLIGENCE Engineering AI Assistant.
-You specialize in:
-- React Native, Expo, Android Gradle, Kotlin, iOS CocoaPods, Swift, Metro bundler.
-- Next.js, React, Node.js, Express, Python Django, TypeScript, Vite.
-- Static code analysis, security auditing, and automated safe code repair.
-Provide clear, authoritative, copy-paste ready technical instructions.`;
-
-  const userContent = contextData
-    ? `Context:\n${JSON.stringify(contextData, null, 2)}\n\nUser Question:\n${query}`
-    : query;
-
-  const aiRes = await callGroqChat(
-    [
-      { role: 'system', content: systemPrompt },
-      { role: 'user', content: userContent },
-    ],
-    { temperature: 0.2, maxTokens: 1200 }
-  );
-
-  if (aiRes.ok && aiRes.content.trim()) {
-    return {
-      answer: aiRes.content.trim(),
-      aiPowered: true,
-      model: aiRes.model,
-    };
-  }
-
-  // Graceful rule-based guidance fallback
-  return {
-    answer: `### Local Engineering Assistant (Rule Fallback)
-
-AI inference is currently running in offline rule mode (rate limit or connection limit).
-- For build errors: Try cleaning cache with \`npx expo start --clear\` or \`cd android && ./gradlew clean\`.
-- For project issues: Run \`devintelligence scan\` or check the Auto Repair Center.
-- For environment issues: Run \`devintelligence doctor\`.`,
-    aiPowered: false,
-  };
-}

package/src/engine/analyzerEngine.test.ts

@@ -1,110 +0,0 @@
-import test from 'node:test';
-import assert from 'node:assert/strict';
-import path from 'node:path';
-import {
-  inspectHostEnvironment,
-  detectProjectEcosystem,
-  diagnoseRawErrorLog,
-  PRESET_ERROR_LOGS,
-} from './analyzerEngine.ts';
-import {
-  getAllProjectReports,
-  getProjectReportById,
-  applyIssueRepairOnDisk,
-  rollbackRepairOnDisk,
-  executeMcpToolCall,
-} from './repairEngine.ts';
-
-test('inspectHostEnvironment accurately reports OS platform and never fakes iOS build support on Linux', () => {
-  const checks = inspectHostEnvironment(true);
-  assert.ok(checks.length >= 10);
-  const nodeCheck = checks.find((c) => c.id === 'env-node');
-  assert.equal(nodeCheck?.status, 'working');
-
-  const xcodeCheck = checks.find((c) => c.id === 'env-xcode');
-  assert.ok(xcodeCheck);
-  if (process.platform !== 'darwin') {
-    assert.equal(xcodeCheck.status, 'os_unsupported');
-    assert.ok(xcodeCheck.explanation.includes('Linux'));
-  }
-});
-
-test('detectProjectEcosystem identifies React Native Expo, Bare RN, Next.js, Express, and Django fixtures', () => {
-  const cwd = process.cwd();
-  assert.equal(
-    detectProjectEcosystem(path.join(cwd, 'fixtures/rn-expo-commerce')).ecosystem,
-    'react-native-expo'
-  );
-  assert.equal(
-    detectProjectEcosystem(path.join(cwd, 'fixtures/rn-bare-fitness')).ecosystem,
-    'react-native-bare'
-  );
-  assert.equal(
-    detectProjectEcosystem(path.join(cwd, 'fixtures/nextjs-saas-portal')).ecosystem,
-    'nextjs'
-  );
-  assert.equal(
-    detectProjectEcosystem(path.join(cwd, 'fixtures/express-api-gateway')).ecosystem,
-    'node-express'
-  );
-  assert.equal(
-    detectProjectEcosystem(path.join(cwd, 'fixtures/django-analytics-service')).ecosystem,
-    'python-django'
-  );
-});
-
-test('getAllProjectReports scans all 5 multi-ecosystem fixtures and detects real engineering issues', () => {
-  const reports = getAllProjectReports();
-  assert.ok(reports.length >= 5);
-
-  const expoReport = getProjectReportById('rn-expo-commerce', true);
-  assert.ok(expoReport.issues.length >= 8);
-  assert.ok(expoReport.issues.some((i) => i.ruleId === 'RN_REANIMATED_PLUGIN_MUST_BE_LAST'));
-  assert.ok(expoReport.issues.some((i) => i.ruleId === 'ANDROID_MANIFEST_INTERNET_PERMISSION'));
-  assert.ok(expoReport.issues.some((i) => i.ruleId === 'IOS_PODFILE_DEPLOYMENT_TARGET_AND_FLIPPER'));
-  assert.ok(expoReport.issues.some((i) => i.ruleId === 'RN_EFFECT_EVENT_LISTENER_LEAK'));
-  assert.ok(expoReport.issues.some((i) => i.ruleId === 'SEC_HARDCODED_SECRET_AND_HTTP'));
-});
-
-test('applyIssueRepairOnDisk patches real file on disk, creates backup, verifies fix, and rollbackRepairOnDisk restores original state', () => {
-  const initial = getProjectReportById('rn-expo-commerce', true);
-  const babelIssue = initial.issues.find((i) => i.ruleId === 'RN_REANIMATED_PLUGIN_MUST_BE_LAST');
-  assert.ok(babelIssue, 'Expected Reanimated babel issue to be detected initially');
-
-  const { repairRecord, updatedReport } = applyIssueRepairOnDisk({
-    projectId: 'rn-expo-commerce',
-    issueId: babelIssue.id,
-  });
-
-  assert.equal(repairRecord.verifiedAfterFix, true);
-  assert.equal(
-    updatedReport.issues.some((i) => i.ruleId === 'RN_REANIMATED_PLUGIN_MUST_BE_LAST'),
-    false,
-    'Issue should be resolved after applying SAFE repair'
-  );
-
-  // Now roll back the repair and confirm the issue returns
-  const { restoredRecord, updatedReport: afterRollback } = rollbackRepairOnDisk({
-    projectId: 'rn-expo-commerce',
-    repairId: repairRecord.id,
-  });
-
-  assert.equal(restoredRecord.rolledBack, true);
-  assert.equal(
-    afterRollback.issues.some((i) => i.ruleId === 'RN_REANIMATED_PLUGIN_MUST_BE_LAST'),
-    true,
-    'Original file and issue should be restored after rollback'
-  );
-});
-
-test('diagnoseRawErrorLog and executeMcpToolCall accurately diagnose traces and expose MCP tools', () => {
-  for (const preset of PRESET_ERROR_LOGS) {
-    const diag = diagnoseRawErrorLog(preset.rawLog);
-    assert.ok(diag.confidence >= 90);
-    assert.ok(diag.safeRepairSteps.length >= 1);
-  }
-
-  const mcpRes = executeMcpToolCall('analyze_react_native', { projectId: 'rn-expo-commerce' });
-  assert.equal(mcpRes.tool, 'analyze_react_native');
-  assert.equal(mcpRes.projectId, 'rn-expo-commerce');
-});