larksuite / larksuite/cli

feat(event): support drive namespace events in event consume (drive.notice.comment_add_v1)

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

Nobody has claimed this yet.

domain/doc domain/event enhancement
Dominant language
Go
Stars
17.3k
Forks
1.4k
Avg merge
2d 4h
Merged PRs (30d)
105

Description

Problem

lark-cli event consume only exposes board / card / im / minutes / task / vc EventKeys. The entire drive namespace is missing — verified on v1.0.68:

$ lark-cli event consume drive.notice.comment_add_v1 --as bot
{"ok":false,"error":{"type":"validation","message":"unknown EventKey: drive.notice.comment_add_v1"}}

The server side is already fully open, which makes this gap surprising:

  • drive user subscription (scope docs:event:subscribe) succeeds per-file: ok:true
  • Comments REST (list / reply / resolve) all work under bot identity
  • Only the consume surface is missing, so bots are forced to poll.

Use case: doc comments as durable, anchored feedback on agent-generated documents (e.g. daily paper digests delivered as docx; user comments on specific entries; bot harvests them into a feedback pipeline, replies and resolves). A natural agent-feedback loop that every doc-producing bot will want.

Why CLI support is the only clean path: apps built on the CLI event bus daemon cannot safely run a side-car SDK WebSocket consumer for the missing keys — events are load-balanced across an app's long connections, so a second consumer steals events from the daemon. The daemon is exactly the right place for this key.

Ask: add drive.notice.comment_add_v1 (ideally the drive event family) to the consumable EventKeys.

Environment: lark-cli 1.0.68, macOS

Contributor guide

No contributing guide indexed for this repository

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 at the lark-cli event consume entry point and trace how its supported EventKeys are defined and validated. Add drive.notice.comment_add_v1 to the consumable keys, then verify that the command accepts it instead of returning an unknown EventKey validation error.

Written by the indexing model from the issue text.

Assessment

Tech stack
go
Domain
cli
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.