Worktrunk Tend CI

Project-specific guidance for tend workflows running on worktrunk (a Rust CLI for managing git worktrees). The generic skills (

tend-running-in-ci

tend-review

tend-triage

Codecov Monitoring

After required CI checks pass, poll

codecov/patch

for i in $(seq 1 5); do
  CODECOV=$(gh pr checks <number> 2>&1 | grep 'codecov/patch' || true)
  if echo "$CODECOV" | grep -q 'pass'; then
    echo "codecov/patch passed"; exit 0
  elif echo "$CODECOV" | grep -q 'fail'; then
    echo "codecov/patch FAILED"; exit 1
  fi
  sleep 60
done

If codecov fails, investigate with

task coverage

cargo llvm-cov report --show-missing-lines | grep <file>

Test Commands

cargo run -- hook pre-merge --yes   # full suite + lints
cargo test --lib --bins             # unit tests only
cargo test --test integration       # integration tests only

CI runs on Linux, Windows, and macOS.

Session Log Paths

Artifact paths:

-home-runner-work-worktrunk-worktrunk/<session-id>.jsonl

Labels

• automated-fix

  — fix PRs from triage and ci-fix workflows

• nightly-cleanup

  — nightly sweep issues and PRs

CI Fix: Prefer Rerun for Transient Infrastructure Failures

Before opening a

fix/ci-*

• Transient infrastructure (link-check timeouts, apt-get flakes, GitHub outages, runner disk issues, codecov upload blips) — do not create a PR. The maintainer will rerun CI. Comment on the run or exit silently; a permanent config change for a one-off timeout is churn the maintainer will close.
• Flaky test (known-flaky or first-seen PTY/shell test) — exit without a PR (same behavior as prior test-flake ci-fix runs).
• Real regression — proceed with a fix PR.

Lychee link-check timeouts are always transient unless the same URL has failed on at least two separate runs within the last few days.

.config/lychee.toml

max_retries = 6

• The previous CI run on the same or a nearby commit passed.
• Only

  [TIMEOUT]

  is reported (not

  404

  /

  403

  /

  410

  ).
• The URL is reachable from a local

  curl

  .

When in doubt, post a comment on the failed run summarizing the diagnosis and wait — don't open a PR.

Applying GitHub Suggestions

Apply the literal suggestion only — change the lines it covers, nothing more. If surrounding lines also need updating, note that in your reply.

Issue Triage

When a bug may already be fixed, ask the reporter:

wt --version

When an issue involves config, shell integration, completions, or unexpected behavior that could stem from user setup, ask the reporter for

wt config show

Closing Duplicates

When an issue is clearly a duplicate, close it after commenting. Use

gh issue close <number>

Suggesting Aliases for Niche Feature Requests

Deflect narrow feature requests to aliases rather than native flags — this keeps the CLI surface small while giving users the behavior immediately. Suggest an alias when:

• The request benefits a small subset of users or a single reporter's workflow (e.g., idempotent create-or-switch, auto-push after merge)
• The behavior can be composed from existing

  wt

  commands or shell primitives
• A shell one-liner or

  wt step

  alias covers the use case

How to respond:

1. Draft the alias (shell function or

   wt step

   alias, whichever fits better)
2. Test it in a scratch worktree — verify it works for the happy path and edge cases (e.g., branch already exists, dirty worktree, missing remote)
3. Post the tested alias in the issue with usage examples
4. Link to the aliases docs and tips & patterns for further recipes

Weekly Maintenance: MSRV & Toolchain

Bump both MSRV and the development toolchain to latest stable − 1. When Rust 1.N is the current stable release, set both to 1.(N−1).

Files to update:

Cargo.toml

rust-version

"1.93"

tests/helpers/wt-perf/Cargo.toml

rust-version

"1.93"

rust-toolchain.toml

channel

"1.93.0"

flake.nix

rust-toolchain.toml

flake.lock

rust-overlay

nix flake update

Commit

flake.lock

cargo run -- hook pre-merge --yes

cargo msrv verify

Weekly Maintenance: Statusline Cache-Check

Detect new in-process cache-miss duplicates introduced by recent changes by running

wt-perf cache-check

wt list statusline --claude-code

# Run from any worktree of this repo
cat > /tmp/statusline-input.json <<'EOF'
{"hook_event_name":"Status","workspace":{"current_dir":"REPLACE_WITH_CWD"},
 "model":{"display_name":"Opus"},"context_window":{"used_percentage":42.0}}
EOF
sed -i '' "s|REPLACE_WITH_CWD|$PWD|" /tmp/statusline-input.json

RUST_LOG=debug cargo run --release -- list statusline --claude-code \
  < /tmp/statusline-input.json 2>&1 \
  | cargo run -p wt-perf -- cache-check

The report flags commands invoked more than once with the same context. Triage each duplicate:

• Legitimate (different cwd, different ref form that can't be normalized, intentional double-call across phases) — note in the response and move on.
• Cache miss (same logical operation should hit cache but doesn't) — open an issue or fix it. Past examples:

  merge_base("main", "<sha>")

  vs

  merge_base("main", "branch")

  keying separately;

  worktree_at(cwd)

  vs

  worktree_at(porcelain_path)

  not canonicalizing.

Baseline as of 2026-04-13: 29 git subprocesses per render on a clean tree (see PR #2209). A jump above ~32 on a clean tree warrants investigation.

README Date Check

The README blockquote opens with a month+year (e.g., "April 2026"). During daily maintenance, verify the month matches the current month and update it if stale.

Per-Workflow References

• PR review:

  @references/review-pr.md

  — Rust idioms, documentation accuracy, duplication search
• Nightly sweep:

  @references/nightly-cleaner.md

  — branch naming