Community Pipeline
@owonwo/community-pipelinev2026.11.21.6
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.
02Behaviors
@owonwo/beads-inboxv2026.11.21.5beads_inbox.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| repoPath? | string | Checkout that owns the beads database |
| bdCommand? | string | bd binary |
| swampCommand? | string | swamp binary used to dispatch the worker workflow |
| swampRepoDir? | string | Swamp workspace that owns the workflows |
| ghCommand? | string | |
| gitCommand? | string | |
| worktreePath? | string | Worktree the drain creates for bead work |
| ntfyTopic? | string | ntfy topic announced before a branch is deleted |
| ntfyServer? | string | |
| githubRepo? | string | Repository whose issues and pull requests are reconciled against beads |
| beadPrefix? | string | Bead id prefix this project uses, e.g. community-app-<hash> |
| refPrefix? | string | Prefix for external_ref dedupe keys, e.g. <refPrefix>:<kind>:<key> |
| prCommentWorkflow? | string | Workflow dispatched for pr-comment intents |
| actor? | string | Beads actor recorded on every queue write |
| allowedCommentAuthors? | array | GitHub logins whose comments may enqueue work |
| mention? | string | A comment must contain this mention to enqueue |
| marker? | string | Comments carrying this marker were written by the agent and are ignored |
| maxAttempts? | number | |
| staleAfterMinutes? | number | An in-progress intent older than this is reclaimed |
| opencodePath? | string | OpenCode binary, used for the documentation judge |
| judgeModel? | string | Model for the documentation meaning judge |
| judgeTimeoutMinutes? | number | Wall 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
| Argument | Type | Description |
|---|---|---|
| maxIssues? | number | Candidates to return; 0 returns every eligible bead |
| contributor? | string | GitHub 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
| Argument | Type | Description |
|---|---|---|
| kind? | string | |
| key? | string | Dedupe 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
| Argument | Type | Description |
|---|---|---|
| maxItems? | number | Intents to process this fire; 0 means every claimable intent |
| maxMinutes? | number | Stop claiming new intents once this budget is spent |
fn auditQueue(runId?: string)
Report intent age and staleness without claiming anything
| Argument | Type | Description |
|---|---|---|
| runId? | string | Current workflow run id |
fn sweepMergedBranches(limit?: number)
Delete the branch behind every merged or closed bead pull request; idempotent sweep
| Argument | Type | Description |
|---|---|---|
| limit? | number | Pull 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
| Argument | Type | Description |
|---|---|---|
| opencodePath? | string | |
| defaultModel? | string | Passed as -m; empty uses the CLI default |
| fallbackModel? | string | Used when a probe run of defaultModel fails (e.g. Go allowance exhausted); empty disables the check |
| defaultTimeoutMinutes? | number | |
| bdCommand? | string | |
| beadsRepoPath? | string | Checkout that owns the beads database |
| claimActor? | string | Beads 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
| Argument | Type | Description |
|---|---|---|
| prompt | string | |
| cwd | string | Working directory for the agent |
| task? | string | Short task label used in the session title |
| workflow? | string | |
| summary? | string | Session title summary; defaults to the first prompt line |
| model? | string | |
| sessionId? | string | Reuse this session id; empty generates a new one |
| beadsActor? | string | Exported as BEADS_ACTOR so bd writes are attributed |
| bead? | string | Bead this session works: claimed before the run, released if it fails, session persisted on it |
| timeoutMinutes? | number | Override 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
| Argument | Type | Description |
|---|---|---|
| topic? | string | ntfy topic; anyone with the name can read it, so treat it as semi-public |
| server? | string | |
| token? | string | Optional 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
| Argument | Type | Description |
|---|---|---|
| title? | string | Notification title |
| message? | string | Body; links render on mobile |
| priority? | enum | |
| tags? | array | ntfy tags, e.g. warning, white_check_mark |
| topic? | string | Override the configured topic |
Resources
notify(7d)— Outcome of one ntfy delivery
@owonwo/pr-requirementsv2026.11.21.2pr_requirements.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| repoPath? | string | Checkout that owns the beads database |
| bdCommand? | string | bd binary |
| ghCommand? | string | |
| githubRepo? | string | Repository whose pull requests are audited |
| frontendPatterns? | array | Regexes; a diff file matching any one makes the PR frontend work |
| marker? | string | Hidden 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
| Argument | Type | Description |
|---|---|---|
| bead | string | Bead whose comments name the pull request to audit |
Resources
audit(30d)— Outcome of one pull request evidence audit
03Workflows
@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 Versions
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
Repository
https://github.com/wigxel/community-appdeno-command6 accepted
Spawns a subprocess with Deno.Command().
- models/agent_run.ts:105 — orchestrates the bd CLI by design
- models/agent_run.ts:165 — probes the agent model by design
- models/agent_run.ts:312 — runs the OpenCode agent by design
- models/beads_inbox.ts:375 — orchestrates gh/bd/git by design
- models/beads_inbox.ts:493 — runs the OpenCode documentation judge by design
- models/pr_requirements.ts:70 — orchestrates gh and bd by design
testing-completeness2 accepted
A source file with no sibling test file.
- models/agent_notify.ts — thin wrapper around one subprocess, exercised by the live pipeline
- models/agent_run.ts — thin wrapper around one subprocess, exercised by the live pipeline
behavior-spelling1 accepted
- (extension) — all clients that will install this extension are current; the behavior spelling is the forward-compatible form
07Platforms
08Labels