feat(worker,docs,e2e): per-turn routable check on tracker-state reads; README pickup/required_labels semantics; Docker E2E

[hojinzs]

Parent: #664 (Epic #651)
리포트 항목: A3, A10, A18 — docs/reports/2026-08-28-upstream-spec-drift-research.md

#664 분할 3/3 — worker + 문서 + E2E.

범위

• packages/worker/src/turn-lease.ts/tracker-state 읽기: turn 사이 재검사를 state 뿐 아니라 issueRoutable(dispatchable + required_labels)로 확장(§7.1/§16.5) — #662의 full snapshot이 전제
• README/docs/configuration.md: required_labels(ALL-of 게이트)와 pickup_labels.include(ANY-of 사전 필터, GitHub/Linear 확장)의 관계; README.md:397(repo init이 셋 다 적용한다는 서술)·README.md:593(라벨 변경이 워커를 중단하지 않는다는 서술) 정정
• Docker E2E: required_labels 미충족 후보 미dispatch + run 중 라벨 제거 시 종료 시나리오, AGENT_TEST.md 표 갱신

완료 기준

• 워커 테스트, Docker E2E 통과, 문서 병합

Blocked by: #721

[moncher-dev]

Workpad — #722 — Cycle 1

Type: fresh pickup
Branch: feat/722-routable-turn-check (base: main)
Draft PR: #771
Cycle opened: 2026-08-30T01:50:35Z · Trigger: Fresh Ready pickup; no linked delivery PR or prior workpad

Status Transitions

• 2026-08-30T01:55:20Z · Ready → In progress · Draft PR feat(worker): check routability between turns #771 created; worker routability implementation is underway (cycle 1 open)
• 2026-08-30T02:10:00Z · In progress → In review · All required-label routability changes and validation are complete in PR feat(worker): check routability between turns #771 (cycle 1 close)

Plan

• 1. Extend worker turn-boundary tracker reads to stop when the issue is no longer routable; add focused worker coverage.
• 2. Clarify required_labels and pickup_labels.include semantics in user documentation.
• 3. Add Docker black-box coverage for missing required labels before dispatch and label removal during a run; update the test guide.
• 4. Wrap-up: re-verified requirements · passed the Completion Bar · added changeset · PR ready · transition to In review

Rework / PR Feedback

None — fresh pickup.

Completion Bar

• In-scope requirements implemented
• pnpm lint
• pnpm test
• pnpm typecheck
• pnpm build
• Docker E2E (integration behavior changed)
• Tests for new functionality
• Code conventions (CLAUDE.md)
• Inline review comments answered (N/A — fresh pickup)

Validation

• pnpm --filter @gh-symphony/worker test -- turn-lease convergence-lifecycle — pass (16 tests).
• pnpm --filter @gh-symphony/orchestrator test -- service — pass.
• pnpm --filter @gh-symphony/worker lint — pass.
• pnpm --filter @gh-symphony/orchestrator lint — pass.
• pnpm --filter @gh-symphony/worker test -- turn-lease convergence-lifecycle — pass (16 tests) after docs/changeset update.
• pnpm format — fails on 90 pre-existing formatting violations; the command also reports AGENT_TEST.md, whose existing table formatting is not Prettier-clean.
• pnpm build — pass.
• pnpm test — pass (after build; workspace package exports require built output).
• pnpm typecheck — pass.
• pnpm lint — pass.
• Changeset: .changeset/turn-routability.md (changeset:patch).
• Docker E2E evidence: required-label-missing and required-label-removed — pass.
• ./e2e/run-e2e.sh required-label-missing 35 — pass.
• ./e2e/run-e2e.sh required-label-removed 40 — pass (SIGTERM and retained workspace asserted).

Delegation (out-of-scope / human / post-merge)

• None.

Progress Log

• 2026-08-30T01:50:35Z: Classified work as Configuration, Execution, Integration, and Observability; created and pushed the feature branch from main.
• 2026-08-30T01:55:00Z: Added fresh-snapshot routability to state-read responses, made the worker stop at the next turn boundary when routability is false, and added focused tests; committed 875b14f and opened Draft PR feat(worker): check routability between turns #771.
• 2026-08-30T01:56:20Z: Clarified the ALL-of required-label gate versus the GitHub/Linear ANY-of pickup include filter; expanded TC-19 with both label-loss boundaries; added patch changeset and committed 96d86d6.
• 2026-08-30T02:05:00Z: Added Docker required-label fixtures, workflow configuration injection, and runner scenarios; committed ef84aeb.
• 2026-08-30T02:09:00Z: Passed full build, test, typecheck, lint, and both Docker required-label cases; refreshed PR body and prepared handoff.

Blockers

None