liquiddesign/liquid-monitor-connector

Connector mezi webem a Liquid Monitor

v2.1.0 2026-06-06 08:24 UTC

Requires

• php: >=8.1
• guzzlehttp/guzzle: ^7.0
• liquiddesign/base: ^2.0.33
• nesbot/carbon: ^2.0 || ^3.0
• nette/application: ^3.0
• nette/di: ~3.0
• nette/http: ^3.0
• nette/security: ^3.0
• nette/utils: ^3.0 || ^4.0
• symfony/console: ^7.0 || ^8.0
• symfony/dotenv: ^7.0 || ^8.0
• symfony/process: ^7.0 || ^8.0
• tracy/tracy: ^2.0

Requires (Dev)

• composer/composer: ~2.0
• liquiddesign/codestyle: ~3.0.9
• liquiddesign/migrator: ~1.0
• nette/tester: ^2.0
• phpcompatibility/php-compatibility: ^9.0
• phpstan/phpstan-nette: ^2.0

MIT

README

Connector mezi webem a Liquid Monitor.

Components

• Cron (src/Cron.php) — Nette DI integrace pro produkční reporting (schedule-job, error logging, health check).
• orchestrator:run (bin/orchestrator-run) — autonomous programming worker. Pollne /api/orchestrator/worker/poll, v repo-mode pracuje přímo v repu (volitelně git worktree), spustí tmux + interaktivní Claude Code REPL (send-keys, --resume), doručí brief, parsuje JSON milníky, spustí composer test a zapíše triage_result zpět na monitor.
• orchestrator-init (bin/orchestrator-init) — jednorázový setup hostu: vygeneruje <repo>/.orchestrator/.env, doplní .orchestrator/ do .gitignore a ověří kredity proti monitoru.

Starý bin/triage-pull (read-only claude -p) je nahrazen orchestrátorem — nepoužívat.

Orchestrator worker setup

1. Projekt na monitoru

php artisan triage:provision-project <id> --json --repo-path=/opt/autonomy/my-app

Vytvoří triage_api_key, zapne orchestrator_enabled a založí git context source pro daný repo path.

2. Host (z kořene repa)

/path/to/liquid-monitor-connector/bin/orchestrator-init

Vypíše .env do <repo>/.orchestrator/.env. Potřeba jsou jen dvě hodnoty:

ORCHESTRATOR_MONITOR_URL=https://monitor.lqd.cz
ORCHESTRATOR_API_KEY=trk_…

Kapacita, claude_binary a turn timeout přicházejí z monitoru (orchestrator_settings); odpovídající env proměnné jsou jen volitelný debug override. Alias env vars: TRIAGE_MONITOR_URL, TRIAGE_API_KEY, …

3. Cron

* * * * * /path/to/liquid-monitor-connector/bin/orchestrator-run --env-file=/opt/autonomy/my-app/.orchestrator/.env >> /var/log/orchestrator-run.log 2>&1

Pre-flight

• git, tmux, claude v PATH (kontroluje i orchestrator-init)
• orchestrator_repo_path na projektu ukazuje na existující clone
• Repo-mode (default): čistý pracovní strom (modifikované tracked soubory blokují běh; untracked se ignorují)

Development

composer install
composer check-code