Repository health & dependency repair system with automated monitoring (#53)

* Initial plan

* Phase 1 & 2: Fix dependency versions and create repair/monitoring infrastructure

Co-authored-by: SMSDAO <[email protected]>

* Harmonize all TypeScript and @types/node versions across workspace

Co-authored-by: SMSDAO <[email protected]>

* Final: Complete repository health and dependency repair implementation

Co-authored-by: SMSDAO <[email protected]>

* Update .husky/pre-commit

Co-authored-by: Copilot <[email protected]>

* Update scripts/repair-dependencies.sh

Co-authored-by: Copilot <[email protected]>

* Apply code review fixes: improve error handling, security, and completeness

- Add ORACLE-REPORT.md to .gitignore (generated artifact)
- Fix wc -l empty string counting in master.sh and oracle.sh
- Fix report generation duplicate analysis in oracle.sh (cache results)
- Fix filename-with-spaces handling in pre-commit hook (use while-read loop)
- Fix git add security issue in pre-commit (safe iteration)
- Add missing packages to harmonization checks (frames, strategy-worker)
- Fix GitHub Actions cd command to use subshell
- Remove unused badge generation steps from workflow

Addresses review comments from copilot-pull-request-reviewer[bot]

Co-authored-by: SMSDAO <[email protected]>

* Fix Next.js version in packages/frames to match harmonized 14.2.18

- Updated packages/frames/package.json: next ^14.1.0 → 14.2.18
- Ensures all 3 packages with Next.js use same version
- Completes dependency harmonization across all packages

All harmonization checks now pass successfully.

Co-authored-by: SMSDAO <[email protected]>

---------

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: SMSDAO <[email protected]>
Co-authored-by: Copilot <[email protected]>

Author: 3 people

.gitignore

@@ -31,6 +31,7 @@ web-build/
 
 # Generated reports
 AUDIT-REPORT.md
+ORACLE-REPORT.md
 
 # Smart Brain cache
 .smartbrain/cache/

.husky/_/husky.sh

@@ -6,4 +6,4 @@ Please remove the following two lines from $0:
 . \"\$(dirname -- \"\$0\")/_/husky.sh\"
 
 They WILL FAIL in v10.0.0
-"
+"

.smartbrain/README.md

@@ -108,6 +108,9 @@ CastQuest Ecosystem
 
 # Auto-deploy with validation
 .smartbrain/brain.sh auto
+
+# Run Smart Brain Oracle for insights
+.smartbrain/oracle.sh all
 ```
 
 ### Full Auto-Deploy Workflow
@@ -200,18 +203,81 @@ Protected Paths:
 
 ## Integration with Master.sh
 
-The Smart Brain works seamlessly with `scripts/master.sh`:
+The Smart Brain works seamlessly with `scripts/master.sh` and the Oracle:
 
 ```bash
 # Use Smart Brain for git operations
 .smartbrain/brain.sh auto
 
+# Use Oracle for dependency insights
+.smartbrain/oracle.sh all
+
 # Use master.sh for system operations
 scripts/master.sh deploy production
 scripts/master.sh workers start
 scripts/master.sh monitor
+
+# Combined health workflow
+.smartbrain/oracle.sh all && scripts/master.sh health
+```
+
+## Smart Brain Oracle
+
+The Smart Brain Oracle provides AI-powered repository insights:
+
+### Features
+
+- **Dependency Health Analysis**: Version consistency and compatibility checks
+- **Security Vulnerability Detection**: Automated scanning for known issues
+- **Version Upgrade Recommendations**: Intelligent upgrade suggestions with compatibility analysis
+- **Deprecated Package Monitoring**: Track and alert on obsolete packages
+- **Performance Improvement Suggestions**: Optimization recommendations
+- **Monorepo Structure Analysis**: Architecture insights and improvements
+- **Predictive Maintenance Warnings**: Proactive alerts before issues arise
+- **Dependency Graph Visualization**: Visual representation of relationships
+- **Smart Conflict Resolution**: Intelligent dependency conflict fixing
+
+### Oracle Usage
+
+```bash
+# Run all analyses
+.smartbrain/oracle.sh all
+
+# Specific analyses
+.smartbrain/oracle.sh analyze        # Dependency health
+.smartbrain/oracle.sh security       # Security scan
+.smartbrain/oracle.sh upgrades       # Upgrade recommendations
+.smartbrain/oracle.sh deprecated     # Deprecated packages
+.smartbrain/oracle.sh performance    # Performance tips
+.smartbrain/oracle.sh structure      # Monorepo analysis
+.smartbrain/oracle.sh warnings       # Predictive warnings
+.smartbrain/oracle.sh graph          # Dependency graph
+.smartbrain/oracle.sh conflicts      # Conflict resolution
+.smartbrain/oracle.sh integration    # System integration status
+.smartbrain/oracle.sh report         # Comprehensive report
+
+# View generated report
+cat ORACLE-REPORT.md
 ```
 
+### Oracle Integration with CI/CD
+
+The Oracle is integrated into the GitHub Actions workflow:
+
+```yaml
+# .github/workflows/dependency-health.yml
+- name: Run Smart Brain Oracle
+  run: .smartbrain/oracle.sh report
+
+- name: Upload Oracle Report
+  uses: actions/upload-artifact@v3
+  with:
+    name: oracle-report
+    path: ORACLE-REPORT.md
+```
+
+See [docs/DEPENDENCY-HEALTH.md](../docs/DEPENDENCY-HEALTH.md) for comprehensive documentation.
+
 ## Configuration
 
 Configuration is stored in `.smartbrain/config.json`:

apps/admin/package.json

@@ -33,13 +33,13 @@
     "zustand": "^4.4.7"
   },
   "devDependencies": {
-    "@types/node": "^20.10.0",
+    "@types/node": "20.10.6",
     "@types/react": "^18.2.0",
     "@types/react-dom": "^18.2.0",
     "@types/ws": "^8.5.10",
     "autoprefixer": "^10.4.16",
     "postcss": "^8.4.32",
     "tailwindcss": "^3.4.0",
-    "typescript": "^5.3.0"
+    "typescript": "5.3.3"
   }
 }

packages/core-services/package.json

@@ -34,10 +34,16 @@
   "devDependencies": {
     "@types/bcrypt": "^5.0.2",
     "@types/cors": "^2.8.17",
+    "@types/node": "20.10.6",
     "@types/express": "^4.17.21",
     "@types/jsonwebtoken": "^9.0.5",
     "@types/node": "^20.10.6",
     "@types/nodemailer": "^6.4.14",
+    "tsx": "^4.7.0",
+    "typescript": "5.3.3",
+    "tsc-alias": "^1.8.8",
+    "vitest": "^1.1.1",
+    "eslint": "^8.56.0",
     "@types/pg": "^8.16.0",
     "@typescript-eslint/eslint-plugin": "^6.18.0",
     "@typescript-eslint/parser": "^6.18.0",

packages/frames/package.json

@@ -12,7 +12,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "next": "^14.1.0",
+    "next": "14.2.18",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "frames.js": "^0.11.0",
@@ -21,10 +21,10 @@
     "zod": "^3.22.4"
   },
   "devDependencies": {
-    "@types/node": "^20.10.6",
+    "@types/node": "20.10.6",
     "@types/react": "^18.2.48",
     "@types/react-dom": "^18.2.18",
-    "typescript": "^5.3.3",
+    "typescript": "5.3.3",
     "eslint": "^8.56.0",
     "eslint-config-next": "^14.1.0",
     "@typescript-eslint/eslint-plugin": "^6.18.0",

packages/neo-ux-core/package.json

@@ -21,6 +21,6 @@
   "devDependencies": {
     "@types/react": "^18.0.0",
     "@types/react-dom": "^18.0.0",
-    "typescript": "^5.3.0"
+    "typescript": "5.3.3"
   }
 }

packages/sdk/package.json

@@ -19,10 +19,10 @@
     "docs:json": "typedoc --json ../../docs-site/sdk/api.json"
   },
   "devDependencies": {
-    "@types/node": "^20.0.0",
+    "@types/node": "20.10.6",
     "typedoc": "^0.25.0",
     "typedoc-plugin-markdown": "^3.17.0",
-    "typescript": "^5.3.0"
+    "typescript": "5.3.3"
   },
   "dependencies": {
     "viem": "^2.0.0"

packages/strategy-worker/package.json

@@ -15,6 +15,6 @@
   },
   "devDependencies": {
     "ts-node": "^10.9.2",
-    "typescript": "^5.4.0"
+    "typescript": "5.3.3"
   }
 }