self-heallm/laravel-self-heallm

Laravel package for automated error triage and LLM-powered self-healing.

v0.3.0 2026-05-05 13:42 UTC

Requires

• php: ^8.2
• illuminate/console: ^10.0|^11.0|^12.0|^13.0
• illuminate/contracts: ^10.0|^11.0|^12.0|^13.0
• illuminate/filesystem: ^10.0|^11.0|^12.0|^13.0
• illuminate/http: ^10.0|^11.0|^12.0|^13.0
• illuminate/support: ^10.0|^11.0|^12.0|^13.0

Requires (Dev)

• orchestra/testbench: ^8.0|^9.0|^10.0|^11.0
• phpunit/phpunit: ^10.5|^11.0|^12.0

MIT

README

Open-source Laravel package that detects recent application errors, asks an LLM for a fix proposal via an OpenAI-compatible API, validates safety rules, applies fixes in hybrid mode, and sends healing reports.

What It Does

• Detects recent app errors and builds a repair context.
• Requests a fix proposal from an OpenAI-compatible model.
• Validates proposed changes against strict safety rules.
• Applies validated fixes in dry-run or auto-apply mode.
• Sends reports to chat/monitoring channels.

Quick Start

1) Install

composer require self-heallm/laravel-self-heallm
php artisan vendor:publish --tag=self-heal-config

2) Configure

Main config file: config/self-heal.php

Supported sections:

• OpenAI: openai.base_url, openai.token, openai.model, openai.timeout
• Telegram: telegram.bot_token, telegram.user_id, telegram.enabled
• Slack: slack.enabled, slack.webhook_url
• Generic webhook: webhook.enabled, webhook.url, webhook.token
• Sentry: sentry.enabled, sentry.dsn, sentry.environment
• Modes: enabled, auto_apply, dry_run
• Safety: allowed_paths, forbidden_paths, max_files_per_fix
• Deduplication: deduplication.enabled, deduplication.ttl_seconds, deduplication.store_path
• Model context size: context.max_file_chars
• Reporting: JSONL fallback path via reporting.json_path

Example .env values:

SELF_HEAL_ENABLED=true
SELF_HEAL_AUTO_APPLY=false
SELF_HEAL_DRY_RUN=true
SELF_HEAL_OPENAI_BASE_URL=https://api.openai.com/v1
SELF_HEAL_OPENAI_TOKEN=sk-...
SELF_HEAL_OPENAI_MODEL=gpt-4.1-mini
SELF_HEAL_TELEGRAM_BOT_TOKEN=123:abc
SELF_HEAL_TELEGRAM_USER_ID=123456789
SELF_HEAL_SLACK_ENABLED=false
SELF_HEAL_SLACK_WEBHOOK_URL=
SELF_HEAL_WEBHOOK_ENABLED=false
SELF_HEAL_WEBHOOK_URL=
SELF_HEAL_WEBHOOK_TOKEN=
SELF_HEAL_SENTRY_ENABLED=false
SELF_HEAL_SENTRY_DSN=
SELF_HEAL_DEDUP_ENABLED=true
SELF_HEAL_DEDUP_TTL_SECONDS=600
SELF_HEAL_CONTEXT_MAX_FILE_CHARS=12000

3) Run

php artisan self-heal:run

Security Model

• Accepts fixes only for whitelisted paths.
• Rejects forbidden paths even if suggested by the model.
• Rejects empty replacement targets.
• Applies validated patches automatically only with dry_run=false and auto_apply=true.
• Skips duplicate error fingerprints during deduplication TTL.

Reporting Channels

• Telegram notifications.
• Slack incoming webhook notifications.
• Generic webhook (POST) notifications.
• Sentry envelope event reporting.
• JSON fallback report when enabled.