finish-task

Finish Task

Reply in Russian. The server appends the PR link idempotently, completes the selected generic

target, and adds a clickable task link to the PR body; clients never send credentials.

1. Config. Read task_board from .review.yml, otherwise get_board_config(). Use only

type, project, create_target, done_target, and options. If no board is resolved,

report a board-less no-op.

1. Resolve key and PR. Match key_pattern on the current branch, newest briefs file, or

gh pr view --json title,body; otherwise ask. Resolve the PR URL with `gh pr view --json url -q

.url` (or ask). Missing key or URL is a no-op.

1. Discover. Call `get_board_targets(board_type=<type>, project=<project>,

provider_options=<task_board.options or {}>). Select done_target from targets` with a done

purpose. For each option with required_for containing finish, resolve its value from

choices; if required metadata is missing, ask instead of guessing.

1. Offer + confirm. Show the PR link and the resolved done target by its label plus every

selected option, and state that a task link will be prepended to the PR body. Ask whether to add an optional note. Write only after explicit confirmation;

never write to the board silently.

1. Write. Call

   finish_task(key=<key>, pr_url=<url>, note=<note or null>, board_type=<type>,
               target=<done_target or null>, provider_options=<task_board.options or {}>)

On status == "error", report the reason in Russian and stop.

1. Re-index. Call `sync_board(board=<project or null>, board_type=<type>,

provider_options=<task_board.options or {}>)`, then report the write and sync result. When

already_closed is true, state that no duplicate PR link was added. Report the task link from

task_link_status, not from task_link_added alone: added — the link was written now;

already_present — it was already in the PR body, so report it as normal (an idempotent no-op,

never as a problem); failed — only then relay the warning verbatim, and the board write still

succeeded. task_link_added stays true only for added (older deploys may omit

task_link_status: treat a missing field as added/failed by whether warnings mention the link).

All reads are fail-open; the explicitly confirmed finish_task call is the only write.