interface / externals / slack_bot / main.py

Async Slack bot using slack_bolt Socket Mode. Maintains per-thread context, downloads user files into the sandbox, posts emoji status updates while streaming.

Event handlers

Per-message flow

1. Generate an 8-char request_id.
2. Spawn tail_logs task to monitor the agent log file for matching request_id markers and update emoji status.
3. Download any file attachments via download_slack_file() into $GHOST_SANDBOX_DIR; inject system notes about the new files.
4. POST to $GHOST_API_URL with X-Ghost-Key.
5. Strip image-markdown from the response and re-upload extracted images via files_upload_v2().
6. Cancel tail_logs on completion.

State

• USER_CACHE — user_id → real_name mapping.
• BOT_USER_ID — cached bot identity.
• MAINTENANCE_MODE — flag to skip processing (set with --maintenance CLI flag).
• LOG_FILE_PATH — agent log path (--log-file).

Slash command router

interface/slack_project_commands.py is a stateless shlex-based router for /project ... commands:

• list [status] · new <title> · resume <pid> · switch <pid> · exit · status
• task add <desc> · task done <tid> [summary] · events [limit]
• advance — async-only; the placeholder response triggers advance_async() in the bot handler, which calls core.project_advancer.advance_once().

Environment