feat: create supervisor module skeleton (t311.2)

[alex-solovyev]

Summary

Creates .agents/scripts/supervisor/ directory with 18 module files containing function stubs, wired into supervisor-helper.sh via source statements.

Part of t311 modularisation plan. Ref #1199

Files created

• _common.sh — shared helpers (db, logging)
• batch.sh, cleanup.sh, cron.sh, database.sh, deploy.sh, dispatch.sh, evaluate.sh, git-ops.sh, issue-sync.sh, lifecycle.sh, memory-integration.sh, pulse.sh, release.sh, self-heal.sh, state.sh, todo-sync.sh, utility.sh

Verification

• bash -n supervisor-helper.sh passes (syntax check)
• 19 files changed, 939 insertions

Summary by CodeRabbit

• Chores
  • Established foundational supervisor module architecture with placeholder stubs for task lifecycle management, batch processing, deployment, state management, Git operations, and worker coordination.
  • Added common utilities including logging, database operations, and SQL escaping for the supervisor framework.

[gemini-code-assist]

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

This PR modularizes the supervisor system by introducing a shared common utilities script (_common.sh with database, logging, and SQL escaping helpers) and 17 placeholder module scripts across batch management, deployment, state, lifecycle, integrations, and runtime operations—all wired into supervisor-helper.sh through automated module sourcing with two declared public constants (SUPERVISOR_DIR and SUPERVISOR_DB).

Changes

Cohort / File(s)	Summary
Supervisor Core .agents/scripts/supervisor-helper.sh	Added module loading block sourcing 17 supervisor module files and declared SUPERVISOR_DIR and SUPERVISOR_DB as readonly public constants.
Common Utilities .agents/scripts/supervisor/_common.sh	Introduced shared helpers: db() (SQLite wrapper), logging functions (log_info, log_success, log_warn, log_error, log_verbose), sql_escape(), and log_cmd() for structured command logging.
Task Management supervisor/batch.sh, supervisor/dispatch.sh, supervisor/evaluate.sh	Added placeholder functions for batch operations (create/list/status/cancel), task dispatching (dispatch/can-dispatch/next-task), and task evaluation (evaluate/parse-signals/AI-evaluation/quality-gate).
State & Database supervisor/state.sh, supervisor/database.sh	Scaffolded state functions (batch/task/worker state, persistence/loading) and database functions (init/migrate/backup/restore).
Lifecycle & Deployment supervisor/lifecycle.sh, supervisor/deploy.sh, supervisor/cleanup.sh, supervisor/cron.sh, supervisor/release.sh	Added stubs for lifecycle transitions, deployment workflows (deploy/status/rollback), resource cleanup (worktrees/orphans/PID), cron pulse management, and release automation.
Git & Issue Integration supervisor/git-ops.sh, supervisor/issue-sync.sh, supervisor/todo-sync.sh	Introduced placeholders for git operations (branch creation/worktree management), GitHub issue synchronization (create/update/link/close), and TODO.md metadata parsing/syncing.
Runtime & Memory supervisor/pulse.sh, supervisor/self-heal.sh, supervisor/memory-integration.sh, supervisor/utility.sh	Added pulse cycle orchestration (9-phase execution), self-healing stubs (detect/recover/cleanup/restart), memory pattern tracking (store/record/query recommendations), and utility helpers (duration/priority/notifications).

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related issues

• t311: Modularise oversized shell scripts #1197: Implements the exact module-splitting and supervisor module skeleton described in the design task.
• t311.3: Extract supervisor modules #1200: Adds and exposes the same supervisor module surfaces (batch, dispatch, lifecycle, pulse, release, todo-sync, git-ops, issue-sync).
• t311.2: Create module skeleton for supervisor-helper.sh #1199: Creates the supervisor module structure with _common.sh and module scripts sourced in supervisor-helper.sh.

Possibly related PRs

• feat: distributed task claiming via GitHub Issue assignees (t164) #621: Modifies supervisor-helper.sh with issue-sync and git-ops integration changes that directly complement this PR's module loading.
• feat: add 3-tier outcome evaluation and re-prompt cycle to supervisor (t128.3) #378: Extends supervisor-helper with evaluation and reprompt functions that leverage the new common utilities and module scaffolding introduced here.
• feat: add memory and self-assessment integration to supervisor (t128.6) #380: Implements memory recall and storage functionality that utilizes the newly sourced memory-integration module and declared constants.

Poem

🔧 Scaffolding Dreams
Seventeen modules stand in careful rows,
Each placeholder waits where logic flows,
Shell scripts dancing in modular grace,
A DevOps framework finds its place! ✨

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feature/t311.2

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

�[0;34m[INFO]�[0m Latest Quality Status:
SonarCloud: 0 bugs, 0 vulnerabilities, 15 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Thu Feb 12 06:07:37 UTC 2026: Code review monitoring started
Thu Feb 12 06:07:37 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 15

📈 Current Quality Metrics

• BUGS: 0
• CODE SMELLS: 15
• VULNERABILITIES: 0

Generated on: Thu Feb 12 06:07:40 UTC 2026

---

Generated by AI DevOps Framework Code Review Monitoring

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud