Skip to content

docs: add 'why does this exist' comments to non-obvious logic#68

Open
marcus wants to merge 1 commit intomainfrom
why-annotator
Open

docs: add 'why does this exist' comments to non-obvious logic#68
marcus wants to merge 1 commit intomainfrom
why-annotator

Conversation

@marcus
Copy link
Owner

@marcus marcus commented Mar 22, 2026

Summary

  • Annotate the four files with the highest density of non-obvious logic: budget calculations, tmux scraping, orchestrator review inference, and task selection scoring
  • Fix factually incorrect existing comment claiming "2x on day before reset, 3x on last day" — the formula 3 - remainingDays actually yields 1x with 2 days left and 2x on the last day
  • Comments only — no behavioral changes

Test plan

  • go build ./... passes
  • go vet ./... passes
  • Tests pass for all four modified packages

🤖 Generated with Claude Code


Automated by nightshift

Annotate budget calculations (multiplier formula, copilot conversion,
daytime reservation, reserve), tmux scraping (timeouts, capture ranges,
content thresholds, fallback regex), orchestrator (review keyword
heuristic, hand-rolled ASCII lowercasing), and task selection (scoring
constants, assignment lifetime). Also fixes the factually incorrect
existing comment that claimed "2x on day before reset, 3x on last day"
when the formula actually gives 1x/2x.

Comments only — no behavioral changes.

Nightshift-Task: why-annotator
Nightshift-Ref: https://github.com/marcus/nightshift

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant