crueber/walhub
Watch
1
0
Fork
You've already forked walhub
 0
Code Issues 2 Pull requests Projects Releases Packages Wiki Activity

Plan #288: GitHub-style runner design #304

Merged
crueber merged 2 commits from docs/issue-288 into main 2026-09-10 20:16:43 +00:00
Conversation 0 Commits 2 Files changed 2 +498
crueber commented 2026-09-10 20:14:04 +00:00
Owner
Copy link

Design plan for #288 (docs only, no implementation until reviewed).

New: docs/features/12_runner.md — researched runner plan with numbered decisions D1–D8 (pull-based model, bucket-native CAS queue, long-poll claim + leases, art_/wrt_/wjt_ tokens, in-repo workflows, secretbox secrets, checks/logs/artifacts reporting, security caps, R1/R2/R3 rollout slices), prior-art research (GHA protocol, act_runner, Woodpecker), testing strategy, non-goals + open questions Q1–Q6 for Chris. No law-1 amendment proposed (reserve container draft in §10). Linked from docs/features/README.md table.

Acceptance: plan covers runner model + protocol, job format + triggers, execution/isolation, secrets, checks integration, logs, artifacts, security caps, UI, testing, non-goals; ends with awaiting-review marker naming Chris; zero code changes (git status: 1 new doc + 1 README table row).

Do NOT merge until the plan itself is reviewed — implementation waits on #288 approval.

Design plan for #288 (docs only, no implementation until reviewed). New: docs/features/12_runner.md — researched runner plan with numbered decisions D1–D8 (pull-based model, bucket-native CAS queue, long-poll claim + leases, art_/wrt_/wjt_ tokens, in-repo workflows, secretbox secrets, checks/logs/artifacts reporting, security caps, R1/R2/R3 rollout slices), prior-art research (GHA protocol, act_runner, Woodpecker), testing strategy, non-goals + open questions Q1–Q6 for Chris. No law-1 amendment proposed (reserve container draft in §10). Linked from docs/features/README.md table. Acceptance: plan covers runner model + protocol, job format + triggers, execution/isolation, secrets, checks integration, logs, artifacts, security caps, UI, testing, non-goals; ends with awaiting-review marker naming Chris; zero code changes (git status: 1 new doc + 1 README table row). Do NOT merge until the plan itself is reviewed — implementation waits on #288 approval.
Researched design plan per #288: pull-based external runners, bucket-native
queue with CAS claim/lease protocol, art_/wrt_/wjt_ token shapes, in-repo
workflows, secretbox-sealed secrets, checks/log/artifact reporting, R1/R2/R3
rollout slices. No law-1 amendment (reserve container draft in §10).
Awaiting review — do not implement.
Plan doc fixes from PR #304 review (issue #288):
doc header claimed D1-D9 but only D1-D8 exist; Q6 lived only
in §10 dependency analysis, now cross-referenced in the §9
open-questions list. No implementation, docs only.
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
actions

   
bug
Something is not working

  
cli

   
duplicate
This issue or pull request already exists

  
enhancement
New feature

  
fork

   
forum

   
git storage

   
help wanted
Need some help

  
insights

   
invalid
Something is wrong

  
issues

   
moderation

   
oidc

   
ownership transfer

   
packages

   
pr/merge protection rules

   
projects

   
pull requests

   
question
More information is needed

  
releases

   
sponsorships

   
tags

   
webhooks

   
wiki

   
wontfix
This won't be fixed

No labels
actions
bug
cli
duplicate
enhancement
fork
forum
git storage
help wanted
insights
invalid
issues
moderation
oidc
ownership transfer
packages
pr/merge protection rules
projects
pull requests
question
releases
sponsorships
tags
webhooks
wiki
wontfix
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
crueber/walhub!304
No description provided.