Skip to main content

Community Pipeline

@owonwo/community-pipelinev2026.11.21.6· MIT· 1d agoBEHAVIORSWORKFLOWSACCEPTED WARNINGS
01README

Durable GitHub contributor pipeline for a beads-managed repository: webhook intents, contributor-issue pick, agent work in a worktree, draft PRs with assignee review, and post-merge issue close plus branch cleanup.

02Behaviors4
@owonwo/beads-inboxv2026.11.21.5beads_inbox.ts

Global Arguments

ArgumentTypeDescription
repoPath?stringCheckout that owns the beads database
bdCommand?stringbd binary
swampCommand?stringswamp binary used to dispatch the worker workflow
swampRepoDir?stringSwamp workspace that owns the workflows
ghCommand?string
gitCommand?string
worktreePath?stringWorktree the drain creates for bead work
ntfyTopic?stringntfy topic announced before a branch is deleted
ntfyServer?string
githubRepo?stringRepository whose issues and pull requests are reconciled against beads
beadPrefix?stringBead id prefix this project uses, e.g. community-app-<hash>
refPrefix?stringPrefix for external_ref dedupe keys, e.g. <refPrefix>:<kind>:<key>
prCommentWorkflow?stringWorkflow dispatched for pr-comment intents
actor?stringBeads actor recorded on every queue write
allowedCommentAuthors?arrayGitHub logins whose comments may enqueue work
mention?stringA comment must contain this mention to enqueue
marker?stringComments carrying this marker were written by the agent and are ignored
maxAttempts?number
staleAfterMinutes?numberAn in-progress intent older than this is reclaimed
opencodePath?stringOpenCode binary, used for the documentation judge
judgeModel?stringModel for the documentation meaning judge
judgeTimeoutMinutes?numberWall clock for one documentation judge call
fn queue(maxIssues?: number, contributor?: string)
Filter the work queue to beads or, with a contributor set, that contributor's assigned open GitHub issues (imported as beads); read-only apart from the first import
ArgumentTypeDescription
maxIssues?numberCandidates to return; 0 returns every eligible bead
contributor?stringGitHub login whose assigned open issues the queue picks from; empty falls back to bd ready
fn contributors()
List GitHub logins with at least one open assigned issue
fn enqueueEvent(kind?: string, key?: string, event?: string, action?: string, prNumber?: number, commentId?: string, commentBody?: string, commentAuthor?: string, commentIsBot?: boolean, originWorkflow?: string)
Durably enqueue one webhook delivery; screened for mention, author, and bot noise
ArgumentTypeDescription
kind?string
key?stringDedupe key; derived from the payload when empty
event?string
action?string
prNumber?number
commentId?string
commentBody?string
commentAuthor?string
commentIsBot?boolean
originWorkflow?string
fn processQueue(maxItems?: number, maxMinutes?: number)
Claim queued intents, dispatch their workflow serially, and retry or park failures
ArgumentTypeDescription
maxItems?numberIntents to process this fire; 0 means every claimable intent
maxMinutes?numberStop claiming new intents once this budget is spent
fn auditQueue(runId?: string)
Report intent age and staleness without claiming anything
ArgumentTypeDescription
runId?stringCurrent workflow run id
fn sweepMergedBranches(limit?: number)
Delete the branch behind every merged or closed bead pull request; idempotent sweep
ArgumentTypeDescription
limit?numberPull requests to inspect, newest first

Resources

enqueued(30d)— Outcome of one webhook enqueue decision
process(30d)— Outcome of one queue drain
audit(30d)— Queue age and staleness snapshot
sweep(30d)— Branches deleted behind merged or closed bead pull requests
queue(30d)— Ready beads or contributor issues that no pull request covers
contributors(30d)— GitHub logins with open assigned issues, for the daily run
candidate(30d)— The single pick this fire would work, empty when none
@owonwo/agent-runv2026.11.02.1agent_run.ts

Global Arguments

ArgumentTypeDescription
opencodePath?string
defaultModel?stringPassed as -m; empty uses the CLI default
fallbackModel?stringUsed when a probe run of defaultModel fails (e.g. Go allowance exhausted); empty disables the check
defaultTimeoutMinutes?number
bdCommand?string
beadsRepoPath?stringCheckout that owns the beads database
claimActor?stringBeads actor that claims and releases the bead
fn invoke(prompt: string, cwd: string, task?: string, workflow?: string, summary?: string, model?: string, sessionId?: string, beadsActor?: string, bead?: string, timeoutMinutes?: number)
Run an OpenCode session with a bot(<task>)[<workflow>]: <summary> title
ArgumentTypeDescription
promptstring
cwdstringWorking directory for the agent
task?stringShort task label used in the session title
workflow?string
summary?stringSession title summary; defaults to the first prompt line
model?string
sessionId?stringReuse this session id; empty generates a new one
beadsActor?stringExported as BEADS_ACTOR so bd writes are attributed
bead?stringBead this session works: claimed before the run, released if it fails, session persisted on it
timeoutMinutes?numberOverride the global wall clock; 0 uses it

Resources

run(30d)— Outcome of one labeled OpenCode session

Files

transcript(text/markdown)— Full stdout and stderr of the session
@owonwo/agent-notifyv2026.11.05.1agent_notify.ts

Global Arguments

ArgumentTypeDescription
topic?stringntfy topic; anyone with the name can read it, so treat it as semi-public
server?string
token?stringOptional ntfy access token for a protected topic
fn notify(title?: string, message?: string, priority?: enum, tags?: array, topic?: string)
Send an ntfy notification; used by workflow failure steps
ArgumentTypeDescription
title?stringNotification title
message?stringBody; links render on mobile
priority?enum
tags?arrayntfy tags, e.g. warning, white_check_mark
topic?stringOverride the configured topic

Resources

notify(7d)— Outcome of one ntfy delivery
@owonwo/pr-requirementsv2026.11.21.2pr_requirements.ts

Global Arguments

ArgumentTypeDescription
repoPath?stringCheckout that owns the beads database
bdCommand?stringbd binary
ghCommand?string
githubRepo?stringRepository whose pull requests are audited
frontendPatterns?arrayRegexes; a diff file matching any one makes the PR frontend work
marker?stringHidden marker that keeps the reminder from being posted twice
fn audit(bead: string)
Audit one bead's PR: when the diff touches frontend code and the body has no screenshots, comment on the PR tagging the assignee to add evidence
ArgumentTypeDescription
beadstringBead whose comments name the pull request to audit

Resources

audit(30d)— Outcome of one pull request evidence audit
03Workflows4
@owonwo/github-events-community-app71f2354b-710b-41b3-9820-3b119ff55096

Screen one GitHub webhook delivery and durably enqueue it; never runs the agent itself

enqueueScreen the delivery and store it as a beads intent
1.enqueuecommunity-app-inbox.enqueueEvent— Enqueue or skip; the drain picks it up within ten minutes
2.notify-failureagent-notify.notify— Alert when an event could not be enqueued
@owonwo/drain-community-app4d7e2a9b-8c1f-4a3e-b6d2-9f5c7e3a1b82

Work one contributor-assigned GitHub issue per fire as a draft PR, and drain webhook intents

drainDrain queued intents, sweep branches, then optionally pick and work one contributor issue
1.process-eventscommunity-app-inbox.processQueue— Drain one queued webhook intent (PR comment or merge) before picking
2.sweep-branchescommunity-app-inbox.sweepMergedBranches— Delete origin branches left behind by merged or closed bead pull requests
3.notify-events-parkedagent-notify.notify— Alert when a webhook intent gave up after its retries
4.notify-events-failureagent-notify.notify— Alert when the webhook queue itself cannot be drained
5.queuecommunity-app-inbox.queue— Read-only pick from the contributor's assigned issues, imported as beads
6.notify-pickedagent-notify.notify— Send an ntfy alert when an issue is picked up
7.ask-approvaltg-bot.sendMessage— Post the approval card to Telegram with Approve / Skip buttons; best effort, the gate works without it
8.work-gate— Suspends the run until the Telegram tap, a dashboard/CLI approval, or the 12h expiry
9.notify-gate-skipagent-notify.notify— Alert when a pick was skipped for lack of approval (rejected or expired)
10.work— Work the picked issue in an isolated worktree and open a draft PR
11.audit-requirementscommunity-app-requirements.audit— Comment on the PR tagging the assignee when frontend work lacks screenshot evidence
12.notify-doneagent-notify.notify— Send an ntfy alert when the issue work finishes
13.notify-failureagent-notify.notify— Alert when the issue work fails
14.notify-failure-queueagent-notify.notify— Alert when the queue step fails (for example a lock timeout)
@owonwo/pr-comment-community-app61fd812a-8ff5-4bf3-9e73-12dd5d0329c8
respondRead the PR comment and act on it
1.agentagent-run.invoke— Run the PR comment agent
@owonwo/daily-community-app-contributors5c8e1f2a-3b4d-4e5f-8a9b-0c1d2e3f4a5b

Once a day, work one assigned GitHub issue for every contributor who has one

discoverDiscover contributors with open assigned issues
1.contributorscommunity-app-inbox.contributors— List GitHub logins with at least one open assigned issue
2.notify-startagent-notify.notify— Say who is queued for today
3.notify-failureagent-notify.notify— Alert when the daily run fails
workRun the drain once per contributor, then report
1.work-each— Run the drain once per contributor; sequential because all drains share one worktree
2.notify-doneagent-notify.notify— Say the daily run finished
04Previous Versions6
2026.11.21.5MIT

updated dependencies

2026.11.21.4MIT
2026.11.21.3MIT

Modified 1 behaviors. Added 1 workflows

2026.11.21.2MIT
2026.11.21.1MIT

Added 1 behaviors

2026.11.19.1MIT
05Stats
B
75 / 100
Downloads
12
Archive size
46.9 KB
  • Has README or module doc2/2earned
  • README has a code example0/1missing
  • README is substantive0/1missing
  • Most symbols documented0/1missing
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Docs keep secrets in a vault1/1earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License1/2partial

    no LICENSE file

  • Verified public repository2/2earned

07Platforms
08Labels