Module team 

Team mode — hierarchical agent org chart with daemon-managed communication.

A YAML-defined team (architect ↔ manager ↔ N engineers) runs in a tmux session. The daemon monitors panes, routes messages between roles, and manages agent lifecycles.

Modules

artifact

auto_merge

Auto-merge policy engine with confidence scoring.

board

Board management — kanban.md rotation of done items to archive.

board_cmd

board_health

Board health dashboard — task counts, age, blocked chains, throughput.

capability

Workflow capability resolution for topology-independent team behavior.

checkpoint

Progress checkpoint files for agent restart context.

comms

External communication channels for user roles.

completion

config

Team configuration parsed from .batty/team_config/team.yaml.

config_diff

Diff two team configurations to produce a topology change set.

cost

daemon

Core team daemon: poll loop, lifecycle coordination, and routing.

delivery

deps

Dependency graph visualization for board tasks.

doctor

equivalence

Equivalence testing harness for comparing synthetic emulator runs.

errors

estimation

Task time estimation from telemetry — median cycle time by tag set.

events

Structured JSONL event stream for external consumers.

failure_patterns

Rolling failure-signature detection over recent team events.

git_cmd

grafana

Grafana monitoring: bundled dashboard template and CLI commands.

harness

hierarchy

Instance naming and manager↔engineer partitioning.

inbox

Maildir-based inbox messaging system.

layout

tmux layout builder — creates zones and panes from team hierarchy.

merge

Merge orchestration extracted from the team daemon.

message

Team message types and command queue management.

metrics

metrics_cmd

batty metrics — consolidated telemetry dashboard.

nudge

Dependency-aware nudge target selection.

parity

PARITY.md parsing and reporting.

policy

resolver

Resolve board tasks into runnable workflow states.

retrospective

Pure event-log analysis and markdown report generation for retrospectives.

retry

Retry helpers for transient failures with configurable exponential backoff.

review

Review and merge transitions for Batty-managed workflow metadata.

scale

CLI-side scale command: mutates team.yaml to change instance counts or add/remove manager roles. The daemon detects the config change via hot-reload and reconciles the running topology.

spec_gen

Clean-room behavior spec validation, handoff discovery, and parity syncing.

standup

Standup status gathering and delivery helpers.

status

tact

task_cmd

task_loop

Task-loop helpers extracted from the team daemon.

telegram

Native Telegram Bot API client for batty.

telemetry_db

SQLite-backed telemetry database for agent performance tracking.

validation

watcher

Disk-based session monitoring — polls agent output via tmux capture-pane.

workflow

Workflow state model for Batty-managed tasks.

Structs

AssignmentDeliveryResult

InitOverrides

Overrides collected from the interactive init wizard.

TeamLoadSnapshot

Enums

AssignmentResultStatus

Constants

TEAM_CONFIG_DIR

Team config directory name inside .batty/.

TEAM_CONFIG_FILE

Team config filename.

Functions

ack_message

Acknowledge (mark delivered) a message in a member’s inbox by ID, prefix, or REF.

assign_task

Assign a task to an engineer via their Maildir inbox.

attach_team

Attach to a running team session.

disable_nudge

Create a nudge-disabled marker file, disabling the intervention at runtime.

enable_nudge

Remove a nudge-disabled marker file, re-enabling the intervention.

export_run

export_template

Export the current team config as a reusable template.

format_assignment_result

init_from_template

init_team

Scaffold .batty/team_config/ with default team.yaml and prompt templates.

init_team_with_overrides

Scaffold with optional interactive overrides applied to the template YAML.

list_available_templates

list_inbox

List inbox messages for a member.

load_assignment_result

merge_worktree

Merge an engineer’s worktree branch.

nudge_disabled_marker_path

Path to the nudge-disabled marker for a given intervention.

nudge_status

Print a table showing config, runtime, and effective state for each intervention.

pause_marker_path

Path to the pause marker file. Presence pauses nudges and standups.

pause_team

Create the pause marker file, pausing nudges and standups.

purge_inbox

Purge delivered messages from one inbox or all inboxes.

read_message

Read a specific message from a member’s inbox by ID, ID prefix, or REF.

resume_team

Remove the pause marker file, resuming nudges and standups.

run_daemon

Run the daemon loop directly (called by the hidden batty daemon subcommand).

send_message

Send a message to a role via their Maildir inbox.

send_message_as

setup_telegram

Run the interactive Telegram setup wizard.

show_load

Show an estimated team load value from live state, store it, and show recent load trends.

start_team

Start a team session: load config, resolve hierarchy, create tmux layout, spawn the daemon as a background process, and optionally attach.

stop_team

team_config_dir

Resolve the team config directory for a project root.

team_config_path

Resolve the path to team.yaml.

team_events_path

team_status

Show team status.

templates_base_dir

Returns ~/.batty/templates/.

validate_team

Validate team config without launching.

wait_for_assignment_result