Skip to content

docs(kanban): canonical worker-pinning reference (provider, model, effort, --pin-sub, --reclaim) (t_0717f61b) - #1329

Merged
ang-fleet-lander[bot] merged 1 commit into
mainfrom
docs/kanban-worker-pinning-t_0717f61b
Sep 27, 2026
Merged

ang-fleet-lander[bot] merged 1 commit into
mainfrom
docs/kanban-worker-pinning-t_0717f61b

Conversation

@ang-fleet-workers

@ang-fleet-workers ang-fleet-workers Bot commented Sep 27, 2026 •

Copy link
Copy Markdown

Docs wave for card t_0717f61b (Ace 09-27 10:58: document the worker-pinning system).

  • website/docs/user-guide/features/kanban.md: the --pin-sub section becomes the canonical Pinning a kanban card/worker: provider, model, effort reference: flag table, --reclaim context semantics (worker terminated, next run = fresh session seeded from body + comments + same workspace; post a checkpoint first), visibility ([PIN ...], show --json pin fields, source=pin, run spawned event pool: sub-vps-N), sub-0 last resort, aliases refused, fix(kanban): refuse single-sub pin routes (claude-apx/bpx-N, pre-rename aliases) at set time #1116 history.
  • hermes kanban set-model --help: parser description pointing at that section; --reclaim help states the context consequence.

No behaviour change. Tests: test_kanban_sub_pin_optin + test_kanban_effort_cli + test_kanban_batch_set_model = 61 passed.


View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.

…fort, --pin-sub, --reclaim) (t_0717f61b)

Consolidates the --pin-sub section of user-guide/features/kanban.md into one
canonical "Pinning a kanban card/worker: provider, model, effort" section:
flag table (--model/--provider/--effort/--pin-sub/--pin-sub-fallback/
--allow-flagship/--reclaim), what --reclaim does to context (worker
terminated; next run is a fresh session seeded from body + comments + same
workspace; checkpoint first), pin visibility incl. the run's spawned-event
pool (sub-vps-N), and the #1116 history. set-model --help gains a
description pointing at the section and the --reclaim context note.

Verified: `hermes kanban set-model --help` renders the new description;
test_kanban_sub_pin_optin + test_kanban_effort_cli +
test_kanban_batch_set_model: 61 passed.
@ang-fleet-lander

Copy link
Copy Markdown

🤖 merged-by: apollo · lane: discord · gate: BYPASS: FR paused by Ace 2026-09-22; Argus off card review (Ace 09-24 13:08); gate = handoff + CI green + Apollo read · why: worker pinning canonical docs + --help (t_0717f61b, Ace 10:58)

@ang-fleet-lander
ang-fleet-lander Bot added this pull request to the merge queue Sep 27, 2026
Merged via the queue into main with commit 228546d Sep 27, 2026
41 checks passed
@ang-fleet-lander
ang-fleet-lander Bot deleted the docs/kanban-worker-pinning-t_0717f61b branch September 27, 2026 18:25
@ang-fleet-ci-actuators ang-fleet-ci-actuators Bot added the fleetreview:post-merge Ask FleetReview to review this MERGED pull (merge commit vs first parent) label Sep 27, 2026
@ang-prism

ang-prism Bot commented Sep 27, 2026

Copy link
Copy Markdown

FleetReview

Review: post-merge · head 228546d2dfe2 · duration 2m 50s
Profile: full recipe · policy: below-size-and-path-gates
Roster: B-assert-ctx → gpt-6-sol (openai), B-state → gpt-6-sol (openai), C-assert-xhigh → claude-code-opus-5-5 (anthropic), F → gpt-6-sol (openai), G → grok-4.6 (xai), L6 → gpt-6-sol (openai)

Post-merge review (fleetreview:post-merge override): this reviewed the merge commit against its first parent — the bytes that already shipped. It is not a pre-merge gate pass.

Confidence: 3/5

Findings

  • P1 website/docs/user-guide/features/kanban.md:651 — Reclaimed workers do not receive every comment or the full card body · agreed: F (openai)

FleetReview provenance · models: B=gpt-6-sol, C=claude-code-opus-5-5, D=grok-4.6, F=gpt-6-sol · cost: $1.34 · duration: 2m 48s · rounds: 1 · files examined: 2

ang-fleet-workers Bot added a commit that referenced this pull request Sep 27, 2026
FleetReview P1 on #1329: doc claimed a reclaimed worker sees every comment.
build_task_context caps body 8 KB, newest 30 comments at 2 KB each,
10 prior runs at 4 KB/field. Checked against _CTX_MAX_* in kanban_db.py.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

fleetreview:post-merge Ask FleetReview to review this MERGED pull (merge commit vs first parent)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants