stacklok / stacklok/mecatl

Slack bot: live-verify channel streaming, stop, and fallback behavior

Open
#1,398 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
Go
Stars
152
Forks
16
Avg merge
14h 48m
Merged PRs (30d)
536

Description

Summary

Verify the Slack bot's channel behavior against a real Slack workspace and
record the supported behavior in its documentation.

DM behavior has live evidence. Public and private channel handling, native
streaming, stop handling, and streaming fallback are implemented from Slack's
API contract but still carry an explicit live-verification caveat.

Scope

  • Verify an @mention starts a session in a public channel thread.
  • Verify an unmentioned reply in that thread continues the same session.
  • Verify messages outside an activated thread remain ignored.
  • Repeat the flow in a private channel with the checked-in manifest scopes.
  • Verify chat.startStream, appendStream, and stopStream behavior.
  • Verify agent_session_stopped cancels the exact active Mecatl run.
  • Exercise the single-final-message fallback when Slack streaming fails.
  • Record Slack configuration, observable evidence, and any required code or
    manifest corrections.

Completion criteria

  • The documented public and private channel flows have live evidence.
  • Streaming, cancellation, and fallback preserve one reply and one run per
    accepted Slack message.
  • The README and design document state the verified behavior without the
    current caveats.

References

  • #883 and sdk/typescript/examples/slack-bot/DESIGN.md.
  • The Slack bot integration roadmap parent.

Fully or partially written by an AI agent.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with sdk/typescript/examples/slack-bot/DESIGN.md, the README, and the checked-in manifest, then compare the documented caveats with the Slack API behavior in a real workspace. Verify the public and private channel flows, streaming, cancellation, and fallback using the stated completion criteria. Done means the README and design document contain live evidence and any required corrections are recorded.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
backend, documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.