feat(bot): add AI streaming with thinking steps

[johnnyhuy]

Summary

Adds Slack AI streaming support using the new chat_stream() helper from slack-sdk v3.40.0.

Changes

• Upgrade slack-sdk to v3.40.0 (resolved to v3.42.0) for Thinking Steps support
• Replace say() with client.chat_stream() for real-time streaming
• Add thinking steps to show agent processing live:
  • Analyzing question
  • Searching knowledge base
  • Generating response
• Fix import path: slack_sdk.models.messages.chunk (not slack_sdk.models.blocks)

Streaming Flow

PlanBlock: "Processing your request..."
TaskCard: "Analyzing question..." → complete
TaskCard: "Searching knowledge base..." → in_progress → complete
TaskCard: "Generating response..." → in_progress → complete
MarkdownTextChunk: response.answer
→ stream.stop()

Handlers Updated

• app_mention (channel thread replies)
• message (direct messages)
• /wingman slash command

Testing

# Run streaming tests
cd backend && uv run pytest tests/test_streaming.py -v

# All unit tests
uv run pytest tests/test_streaming.py tests/test_file_extraction_units.py -v

20 streaming tests covering:

• Chunk imports (MarkdownTextChunk, TaskUpdateChunk, PlanUpdateChunk)
• Chunk creation and serialization
• Status values
• Integration flow

Documentation Added/Updated

File	Description
docs/local-development.md	NEW Step-by-step local setup with streaming + mise reference
README.md	Updated with AI streaming highlight
docs/getting-started.md	Added streaming preview
docs/setup.md	Cleaned up formatting

⚠️ Build Status

CI checks show backend/frontend build failures. Likely due to uv.lock update for slack-sdk v3.42.0 needing proper Docker rebuild. Please retry checks after approving, or run mise run up --build locally to verify.

Quick Test

# Start services
docker compose up -d postgres chroma

# Run bot with streaming
mise run dev-bot

# 3. DM @Wingman or mention in channel

Docs

• Local Development Guide - Local setup + mise reference
• Getting Started - Quick start
• Setup Guide - Full deployment

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	pypi/​slack-sdk@​3.39.0 ⏵ 3.42.0	+1

View full report

[johnnyhuy]

Build failures detected (backend/frontend build checks). The uv.lock was updated to reflect slack-sdk v3.42.0 which may need to be properly resolved in the Docker build.

Task logged to track fix: "Fix wingman streaming PR build failures"

To retry checks after fix:

# Ensure dependencies are properly synced
cd backend && uv sync
git add uv.lock && git commit --amend --no-edit
git push --force-with-lease