runcard

Runcard 🔗

watch() 🔗

Keep one card live for a multi-job run. Returns ok, fail, waiting, or skipped when there is no Slack token/channel (Dependabot, fork PRs).

Run it in a job with NO needs, continue-on-error: true, and a timeout-minutes above deadlineMinutes. It polls every pollSeconds, posts each failed job once to the thread (failing step, annotations, log tail), and closes with statistics. It exits — never waits — once only approval-gated jobs remain.

Return Type

String !

Arguments

dagger -m github.com/wildbitca/daggerverse/runcard@6edf4b951119acbf92be245ff8954794254f8e6d call \
 watch --repo string --ref string --sha string --actor string --event string --run-id string --run-number string --run-attempt string --server string --rows string --self-job string --event-type string --github-token env:MYSECRET --slack-channel string --workflow-file string --branch string --msg string --title string --runner-prices string --poll-seconds integer --deadline-minutes integer --resume-after string --report-artifacts string --test-reports stringcontent_copy Copied! 

func (m *MyModule) Example(ctx context.Context, repo string, ref string, sha string, actor string, event string, runId string, runNumber string, runAttempt string, server string, rows string, selfJob string, eventType string, githubToken *dagger.Secret, slackChannel string, workflowFile string, branch string, msg string, title string, runnerPrices string, pollSeconds int, deadlineMinutes int, resumeAfter string, reportArtifacts string, testReports string) string  {
	return dag.
			Runcard().
			Watch(ctx, repo, ref, sha, actor, event, runId, runNumber, runAttempt, server, rows, selfJob, eventType, githubToken, slackChannel, workflowFile, branch, msg, title, runnerPrices, pollSeconds, deadlineMinutes, resumeAfter, reportArtifacts, testReports)
}content_copy Copied!

@function
async def example(repo: str, ref: str, sha: str, actor: str, event: str, runid: str, runnumber: str, runattempt: str, server: str, rows: str, selfjob: str, eventtype: str, githubtoken: dagger.Secret, slackchannel: str, workflowfile: str, branch: str, msg: str, title: str, runnerprices: str, pollseconds: int, deadlineminutes: int, resumeafter: str, reportartifacts: str, testreports: str) -> str:
	return await (
		dag.runcard()
		.watch(repo, ref, sha, actor, event, runid, runnumber, runattempt, server, rows, selfjob, eventtype, githubtoken, slackchannel, workflowfile, branch, msg, title, runnerprices, pollseconds, deadlineminutes, resumeafter, reportartifacts, testreports)
	)content_copy Copied!

@func()
async example(repo: string, ref: string, sha: string, actor: string, event: string, runId: string, runNumber: string, runAttempt: string, server: string, rows: string, selfJob: string, eventType: string, githubToken: Secret, slackChannel: string, workflowFile: string, branch: string, msg: string, title: string, runnerPrices: string, pollSeconds: number, deadlineMinutes: number, resumeAfter: string, reportArtifacts: string, testReports: string): Promise<string> {
	return dag
		.runcard()
		.watch(repo, ref, sha, actor, event, runId, runNumber, runAttempt, server, rows, selfJob, eventType, githubToken, slackChannel, workflowFile, branch, msg, title, runnerPrices, pollSeconds, deadlineMinutes, resumeAfter, reportArtifacts, testReports)
}content_copy Copied!

refresh() 🔗

ONE pass that brings the run’s card up to date, then returns. Event-driven alternative to watch: call it from a job that runs when something changes (a job finishing, via needs + if: always()), so no runner is held polling. Returns posted, updated, closed:<ok|fail>, or skipped when there is no Slack token/channel.

It looks the card up by (eventType, runId, runAttempt) and posts a new one only when none exists, reads the run’s jobs once, renders the same rows as watch, and either updates the card in place (status running) or closes it exactly as watch does: final status, test reports merged from artifacts, feature map, breakdown and statistics in the thread. It closes when every job except selfJob has completed and each row has a job, or when final is true. Jobs parked on an approval render “awaiting approval” and the card shows waiting; that is not a close, so nothing is threaded and a later refresh carries it on once the gate opens.

Concurrency: refreshers that run close together each render from the API’s current state, so updates are idempotent and the last writer wins; a stale write is corrected by the next refresh. Two refreshers can still both post a NEW card if neither finds one yet (the first refresh of a run); the lookup before posting makes that rare, not impossible. Have the first job call it early, or accept a rare duplicate.

Differences from watch: failed jobs are threaded once, at close (a one-shot has no memory of what it already posted); a final refresh with jobs still open marks them failed (“watcher deadline”).

Return Type

String !

Arguments

dagger -m github.com/wildbitca/daggerverse/runcard@6edf4b951119acbf92be245ff8954794254f8e6d call \
 refresh --repo string --ref string --sha string --actor string --event string --run-id string --run-number string --run-attempt string --server string --rows string --self-job string --event-type string --github-token env:MYSECRET --slack-channel string --workflow-file string --branch string --msg string --title string --runner-prices string --report-artifacts string --test-reports string --final booleancontent_copy Copied! 

func (m *MyModule) Example(ctx context.Context, repo string, ref string, sha string, actor string, event string, runId string, runNumber string, runAttempt string, server string, rows string, selfJob string, eventType string, githubToken *dagger.Secret, slackChannel string, workflowFile string, branch string, msg string, title string, runnerPrices string, reportArtifacts string, testReports string, final bool) string  {
	return dag.
			Runcard().
			Refresh(ctx, repo, ref, sha, actor, event, runId, runNumber, runAttempt, server, rows, selfJob, eventType, githubToken, slackChannel, workflowFile, branch, msg, title, runnerPrices, reportArtifacts, testReports, final)
}content_copy Copied!

@function
async def example(repo: str, ref: str, sha: str, actor: str, event: str, runid: str, runnumber: str, runattempt: str, server: str, rows: str, selfjob: str, eventtype: str, githubtoken: dagger.Secret, slackchannel: str, workflowfile: str, branch: str, msg: str, title: str, runnerprices: str, reportartifacts: str, testreports: str, final: bool) -> str:
	return await (
		dag.runcard()
		.refresh(repo, ref, sha, actor, event, runid, runnumber, runattempt, server, rows, selfjob, eventtype, githubtoken, slackchannel, workflowfile, branch, msg, title, runnerprices, reportartifacts, testreports, final)
	)content_copy Copied!

@func()
async example(repo: string, ref: string, sha: string, actor: string, event: string, runId: string, runNumber: string, runAttempt: string, server: string, rows: string, selfJob: string, eventType: string, githubToken: Secret, slackChannel: string, workflowFile: string, branch: string, msg: string, title: string, runnerPrices: string, reportArtifacts: string, testReports: string, final: boolean): Promise<string> {
	return dag
		.runcard()
		.refresh(repo, ref, sha, actor, event, runId, runNumber, runAttempt, server, rows, selfJob, eventType, githubToken, slackChannel, workflowFile, branch, msg, title, runnerPrices, reportArtifacts, testReports, final)
}content_copy Copied!

refreshPlan() 🔗

The decision refresh makes, exposed pure so it can be tested on fixtures. Returns JSON {items, outcome, status, close} (outcome is running|approval|done|deadline).

Return Type

String !

Arguments

dagger -m github.com/wildbitca/daggerverse/runcard@6edf4b951119acbf92be245ff8954794254f8e6d call \
 refresh-plan --jobs string --rows string --self-job string --final booleancontent_copy Copied! 

func (m *MyModule) Example(ctx context.Context, jobs string, rows string, selfJob string, final bool) string  {
	return dag.
			Runcard().
			Refreshplan(ctx, jobs, rows, selfJob, final)
}content_copy Copied!

@function
async def example(jobs: str, rows: str, selfjob: str, final: bool) -> str:
	return await (
		dag.runcard()
		.refreshplan(jobs, rows, selfjob, final)
	)content_copy Copied!

@func()
async example(jobs: string, rows: string, selfJob: string, final: boolean): Promise<string> {
	return dag
		.runcard()
		.refreshPlan(jobs, rows, selfJob, final)
}content_copy Copied!

report() 🔗

One final card for a SINGLE-JOB workflow, from that job’s last step. Returns ok, fail or skipped.

Call it with if: always() and --job-status=${{ job.status }}. The rows are the job’s steps as the API reports them at that moment: completed steps only, without the runner’s own Set up job / Post … / Complete job. The log is not published until the job completes, so a failure’s thread carries the failing step and annotations plus a link, not a log tail.

Return Type

String !

Arguments

dagger -m github.com/wildbitca/daggerverse/runcard@6edf4b951119acbf92be245ff8954794254f8e6d call \
 report --repo string --ref string --sha string --actor string --event string --run-id string --run-number string --run-attempt string --server string --job-status string --event-type string --github-token env:MYSECRET --slack-channel string --job-name string --rows string --msg string --title string --test-reports stringcontent_copy Copied! 

func (m *MyModule) Example(ctx context.Context, repo string, ref string, sha string, actor string, event string, runId string, runNumber string, runAttempt string, server string, jobStatus string, eventType string, githubToken *dagger.Secret, slackChannel string, jobName string, rows string, msg string, title string, testReports string) string  {
	return dag.
			Runcard().
			Report(ctx, repo, ref, sha, actor, event, runId, runNumber, runAttempt, server, jobStatus, eventType, githubToken, slackChannel, jobName, rows, msg, title, testReports)
}content_copy Copied!

@function
async def example(repo: str, ref: str, sha: str, actor: str, event: str, runid: str, runnumber: str, runattempt: str, server: str, jobstatus: str, eventtype: str, githubtoken: dagger.Secret, slackchannel: str, jobname: str, rows: str, msg: str, title: str, testreports: str) -> str:
	return await (
		dag.runcard()
		.report(repo, ref, sha, actor, event, runid, runnumber, runattempt, server, jobstatus, eventtype, githubtoken, slackchannel, jobname, rows, msg, title, testreports)
	)content_copy Copied!

@func()
async example(repo: string, ref: string, sha: string, actor: string, event: string, runId: string, runNumber: string, runAttempt: string, server: string, jobStatus: string, eventType: string, githubToken: Secret, slackChannel: string, jobName: string, rows: string, msg: string, title: string, testReports: string): Promise<string> {
	return dag
		.runcard()
		.report(repo, ref, sha, actor, event, runId, runNumber, runAttempt, server, jobStatus, eventType, githubToken, slackChannel, jobName, rows, msg, title, testReports)
}content_copy Copied!

thread() 🔗

Reply in the thread of a run’s card. Returns the reply’s ts, or “” when no card was found in time (best-effort: never throws on Slack errors).

The card is found by metadata — eventType + runId (+ runAttempt) — so a Dagger call in any job of the run can post its inner detail (a test breakdown, a failing flow) under the watcher’s card instead of opening a second one. It retries for waitSeconds, because the job calling it may start before the watcher has posted.

Return Type

String !

Arguments

dagger -m github.com/wildbitca/daggerverse/runcard@6edf4b951119acbf92be245ff8954794254f8e6d call \
 thread --slack-channel string --event-type string --run-id string --text string --run-attempt string --blocks string --wait-seconds integercontent_copy Copied! 

func (m *MyModule) Example(ctx context.Context, slackChannel string, eventType string, runId string, text string, runAttempt string, blocks string, waitSeconds int) string  {
	return dag.
			Runcard().
			Thread(ctx, slackChannel, eventType, runId, text, runAttempt, blocks, waitSeconds)
}content_copy Copied!

@function
async def example(slackchannel: str, eventtype: str, runid: str, text: str, runattempt: str, blocks: str, waitseconds: int) -> str:
	return await (
		dag.runcard()
		.thread(slackchannel, eventtype, runid, text, runattempt, blocks, waitseconds)
	)content_copy Copied!

@func()
async example(slackChannel: string, eventType: string, runId: string, text: string, runAttempt: string, blocks: string, waitSeconds: number): Promise<string> {
	return dag
		.runcard()
		.thread(slackChannel, eventType, runId, text, runAttempt, blocks, waitSeconds)
}content_copy Copied!

cardTs() 🔗

The ts of a run’s card, or “”. For callers that want slack.breakdown or slack.failureDetail under the card rather than a plain reply.

Return Type

String !

Arguments

dagger -m github.com/wildbitca/daggerverse/runcard@6edf4b951119acbf92be245ff8954794254f8e6d call \
 card-ts --slack-channel string --event-type string --run-id string --run-attempt string --wait-seconds integercontent_copy Copied! 

func (m *MyModule) Example(ctx context.Context, slackChannel string, eventType string, runId string, runAttempt string, waitSeconds int) string  {
	return dag.
			Runcard().
			Cardts(ctx, slackChannel, eventType, runId, runAttempt, waitSeconds)
}content_copy Copied!

@function
async def example(slackchannel: str, eventtype: str, runid: str, runattempt: str, waitseconds: int) -> str:
	return await (
		dag.runcard()
		.cardts(slackchannel, eventtype, runid, runattempt, waitseconds)
	)content_copy Copied!

@func()
async example(slackChannel: string, eventType: string, runId: string, runAttempt: string, waitSeconds: number): Promise<string> {
	return dag
		.runcard()
		.cardTs(slackChannel, eventType, runId, runAttempt, waitSeconds)
}content_copy Copied!

cardRows() 🔗

The row logic, exposed pure so it can be tested on fixtures. Returns JSON Item[].

Return Type

String !

Arguments

dagger -m github.com/wildbitca/daggerverse/runcard@6edf4b951119acbf92be245ff8954794254f8e6d call \
 card-rows --jobs string --rows string --self-job stringcontent_copy Copied! 

func (m *MyModule) Example(ctx context.Context, jobs string, rows string, selfJob string) string  {
	return dag.
			Runcard().
			Cardrows(ctx, jobs, rows, selfJob)
}content_copy Copied!

@function
async def example(jobs: str, rows: str, selfjob: str) -> str:
	return await (
		dag.runcard()
		.cardrows(jobs, rows, selfjob)
	)content_copy Copied!

@func()
async example(jobs: string, rows: string, selfJob: string): Promise<string> {
	return dag
		.runcard()
		.cardRows(jobs, rows, selfJob)
}content_copy Copied!

runReports() 🔗

The run’s test reports as ONE merged wildbit.test-report/v1, plus notes for the thread (unreadable artifacts, feature-map drift). Returns JSON {report, notes}; report is the report’s JSON string, “” when there is none.

What watch and report do at close, exposed so a job can reuse it — e.g. to write testing.summaryMarkdown of the whole run to $GITHUB_STEP_SUMMARY — and so the artifact handoff is probed in CI without Slack.

Best-effort: a report that cannot be read is a note, never an error — the card’s verdict comes from the jobs, and the reports only describe it. Only a malformed testReports argument throws, because that is the caller’s wiring.

Return Type

String !

Arguments

dagger -m github.com/wildbitca/daggerverse/runcard@6edf4b951119acbf92be245ff8954794254f8e6d call \
 run-reports --github-token env:MYSECRET --repo string --run-id string --cache-bust string --report-artifacts string --test-reports stringcontent_copy Copied! 

func (m *MyModule) Example(ctx context.Context, githubToken *dagger.Secret, repo string, runId string, cacheBust string, reportArtifacts string, testReports string) string  {
	return dag.
			Runcard().
			Runreports(ctx, githubToken, repo, runId, cacheBust, reportArtifacts, testReports)
}content_copy Copied!

@function
async def example(githubtoken: dagger.Secret, repo: str, runid: str, cachebust: str, reportartifacts: str, testreports: str) -> str:
	return await (
		dag.runcard()
		.runreports(githubtoken, repo, runid, cachebust, reportartifacts, testreports)
	)content_copy Copied!

@func()
async example(githubToken: Secret, repo: string, runId: string, cacheBust: string, reportArtifacts: string, testReports: string): Promise<string> {
	return dag
		.runcard()
		.runReports(githubToken, repo, runId, cacheBust, reportArtifacts, testReports)
}content_copy Copied!