devintelligence 0.0.0-stage → 1.0.1

package/.env.example

@@ -0,0 +1,14 @@
+# DEVINTELLIGENCE — Personal Software Engineering Intelligence System
+# Understand. Diagnose. Repair. Optimize.
+
+# Groq AI API Key (Optional for AI Error Diagnostics & Intelligent Fixes)
+# Note: DEVINTELLIGENCE works 100% offline with zero external API keys required!
+GROQ_API_KEY="your_groq_api_key_here"
+GROQ_MODEL="qwen/qwen3.8-27b"
+
+# Optional Gemini API Key
+GEMINI_API_KEY="MY_GEMINI_API_KEY"
+
+# Local Workstation Configuration
+PORT=3000
+HOST="0.0.0.0"

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 DevIntelligence & NetControl Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -1,3 +1,146 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# DEVINTELLIGENCE
+
+> **Personal Software Engineering Intelligence System**  
+> *Understand. Diagnose. Repair. Optimize.*
+
+DEVINTELLIGENCE is an advanced, locally operating developer intelligence platform and installable library built for daily multi-ecosystem engineering workflows.
+
+It deeply understands your project structure, inspects native mobile configurations (React Native, Expo, Bare RN, Android, iOS), analyzes full-stack web and backend architectures (Next.js, Vite, Node.js, Express, Python, Django), detects architectural, security, and performance bottlenecks, and safely executes verified auto-repairs on disk with automatic rollback snapshots.
+
+---
+
+## ⚡ Core Philosophy
+
+- **Zero Cloud Dependence**: Operates 100% locally on your machine.
+- **Engineered Correctness**: Deep AST and configuration analysis instead of surface-level linting.
+- **Resilient AI Shield**: Integrated with ultra-fast Groq AI (Qwen 27B / Llama 3) for sub-second crash diagnosis. If API limits are reached (HTTP 429) or offline, it **never crashes** — seamlessly degrading to built-in heuristic rule engines with zero downtime.
+- **Safe Auto-Remediation**: Categorizes all fixes into `SAFE` (zero regression risk with timestamped backups), `REVIEW REQUIRED`, and `RISKY`.
+
+---
+
+## 📦 Installation & Library Usage
+
+Install anywhere in your projects:
+
+```bash
+# Global CLI Installation
+npm install -g devintelligence
+
+# Or install as a development dependency / library in any project
+npm install devintelligence --save-dev
+```
+
+### Programmatic Library API
+
+Import DEVINTELLIGENCE directly into your Node.js, TypeScript, or custom developer automation scripts:
+
+```typescript
+import {
+  inspectHostEnvironment,
+  analyzeProjectDirectory,
+  diagnoseRawErrorLogWithAi,
+  applyAllSafeRepairsOnDisk,
+  getProjectReportById,
+} from 'devintelligence';
+
+// 1. Audit developer environment runtimes
+const envReport = inspectHostEnvironment();
+console.log(envReport);
+
+// 2. Perform deep AST & architecture scan on any repository
+const report = analyzeProjectDirectory('/path/to/my-react-native-app');
+console.log(`Overall Health: ${report.scores.overall}/100`);
+
+// 3. AI-Powered crash trace diagnosis with guaranteed rule fallback
+const diagnosis = await diagnoseRawErrorLogWithAi(metroErrorStack);
+console.log(diagnosis.summary, diagnosis.rootCause, diagnosis.safeRepairSteps);
+
+// 4. Automatically apply all safe auto-repairs with rollback protection
+const repairResult = applyAllSafeRepairsOnDisk('my-project-id');
+console.log(`Applied ${repairResult.appliedRepairs.length} safe patches.`);
+```
+
+---
+
+## 🚀 CLI Commands
+
+Run directly without installing via `npx`:
+
+```bash
+# Initialize DEVINTELLIGENCE in current directory
+npx devintelligence init
+
+# Audit host environment (Node, Expo, Android SDK, Gradle, CocoaPods, Xcode)
+npx devintelligence doctor
+
+# Deep AST scan on current project or registered fixture
+npx devintelligence scan [--project=<id>] [--ci]
+
+# Diagnose any build or runtime crash trace with AI + Rule Fallback
+npx devintelligence diagnose "<error_trace>"
+
+# Apply all validated SAFE auto-repairs on disk with backup
+npx devintelligence fix [--project=<id>]
+
+# Generate AI executive engineering advice & prioritized action plan
+npx devintelligence advice [--project=<id>]
+
+# Ask the interactive AI technical assistant directly
+npx devintelligence ai "How do I optimize FlatList windowing in React Native?"
+
+# Run self-testing verification suite across 5 multi-ecosystem fixtures
+npx devintelligence test
+
+# Launch desktop engineering workstation on http://localhost:3000
+npx devintelligence dashboard
+```
+
+---
+
+## 📱 React Native & Native Intelligence
+
+Dedicated, deeply implemented intelligence for Expo Managed, Expo Prebuild (CNG), and Bare React Native CLI:
+
+1. **Initial Project Doctor**: Inspects Node, npm, yarn, pnpm, Bun, Expo SDK, Android SDK, platform-tools, build-tools, JDK, Gradle, AGP, Kotlin, Xcode (macOS), iOS deployment targets, CocoaPods, Metro, Babel, and TypeScript.
+2. **Error Intelligence**: Traces root causes for Metro bundler crashes, Reanimated Babel plugin ordering, Android Gradle merger failures, missing permissions, Hermes runtime exceptions, CocoaPods linkage issues, and Red Screen traces.
+3. **Component Intelligence**: Detects unnecessary re-renders, missing list keys, FlatList performance anti-patterns, hook memory leaks (e.g. uncleaned `AppState` listeners), and accessibility gaps.
+4. **Android Intelligence**: Full inspection of `AndroidManifest.xml`, `build.gradle`, `settings.gradle`, `gradle.properties`, target SDK, and cleartext HTTP policies.
+5. **iOS Intelligence**: Deep audit of `Podfile`, deployment targets, privacy usage keys in `Info.plist`, and native framework linking.
+
+---
+
+## 🖥️ 18-Module Developer Workstation
+
+To launch the desktop-first developer interface locally:
+
+```bash
+npm run dev
+# or
+npx devintelligence dashboard
+```
+
+Open `http://localhost:3000` to access all 18 dedicated modules:
+- **Core**: Command Center, Project Explorer, Project Health.
+- **Mobile & Native**: React Native Doctor, Android Diagnostics, iOS Diagnostics, Error Diagnostics.
+- **Deep Analysis**: Code Intelligence, Design Intelligence, Performance Lab, Security Audit, Dependency Intelligence.
+- **Repair & Delivery**: Auto Repair Center, Visual Testing, Quality Gate, Project History, Environment Manager, Settings & MCP.
+
+---
+
+## 🛠️ Model Context Protocol (MCP) Tools
+
+DEVINTELLIGENCE exposes local MCP tools compatible with Claude Desktop, Cursor, Antigravity, and Gemini:
+
+- `inspect_project`
+- `diagnose_error`
+- `analyze_react_native`
+- `inspect_android_environment`
+- `find_unused_files`
+- `apply_safe_fix`
+- `verify_repair`
+
+---
+
+## 📄 License
+
+MIT © 2026 DEVINTELLIGENCE Engineering Team