copilotkit 4.18.0 → 4.20.0

package/onboarding/prompts/feature/a2ui/start.md

@@ -21,13 +21,13 @@ carry on. Keep a read-only assignment read-only. If no subagent works at all, re
 once:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard checkpoint --phase delegation-unavailable
+npx --prefer-offline --yes copilotkit@4.20.0 onboard checkpoint --phase delegation-unavailable
 ```
 
 Before you end your turn to wait for the developer, report the pause:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard checkpoint --phase awaiting-developer
+npx --prefer-offline --yes copilotkit@4.20.0 onboard checkpoint --phase awaiting-developer
 ```
 
 A turn that ends while the run waits is a pause, not a stop, even when your harness ends it.
@@ -37,7 +37,7 @@ If you stop this run, send one short report before you stop. The friction comman
 the telemetry setting the developer already chose, so it needs no separate question.
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard friction --phase stop --category <slug> --message "<sentences>"
+npx --prefer-offline --yes copilotkit@4.20.0 onboard friction --phase stop --category <slug> --message "<sentences>"
 ```
 
 `--message` takes one or two sentences: the step you stopped at and what stopped it.
@@ -51,7 +51,7 @@ one scoped fix, and sends the report itself when no fix is approved.
 Before any subagent or project process runs, capture the developer's existing work:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard protect
+npx --prefer-offline --yes copilotkit@4.20.0 onboard protect
 ```
 
 Keep the exact protected path list it prints and give that list to every subagent. No
@@ -66,23 +66,20 @@ development/test commands. It must return paths and secret-safe presence checks
 
 Require an existing frontend, agent, and CopilotKit round trip. Start only project-owned
 processes when needed, inspect `/info`, and run
-`npx --prefer-offline --yes copilotkit@4.18.0 verify --expect-runtime oss --round-trip --agent <agent-id> --json`.
+`npx --prefer-offline --yes copilotkit@4.20.0 verify --expect-runtime oss --round-trip --agent <agent-id> --json`.
 Also drive one existing request through the frontend when browser control is available.
 
 Wait for the inspection subagent to finish. Then report that the inspection came back:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard checkpoint --phase research-returned
+npx --prefer-offline --yes copilotkit@4.20.0 onboard checkpoint --phase research-returned
 ```
 
-A refused checkpoint prints its reason and leaves onboarding unaffected. It is not a
-failed step.
-
 If the inspection did not prove the baseline this intent extends, stop here without
 changing files:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard read feature/stop
+npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/stop
 ```
 
 Do not run `login`, select an Intelligence project, add an Intelligence client, mint a
@@ -106,17 +103,11 @@ one.
 After approval, record each approved path before implementation:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
+npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
 ```
 
 If an approved path changed after capture and no implementation step has run, add
 `--with-prior-change`. Continue only when every result starts with `Status: passed`. Do not
 authorize a path the approved plan did not list.
 
-Then report the plan this run is about to implement:
-
-```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard checkpoint --phase plan-written
-```
-
-Then run `npx --prefer-offline --yes copilotkit@4.18.0 onboard read feature/a2ui/implement`.
+Then run `npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/a2ui/implement`.

package/onboarding/prompts/feature/channels/implement.md

@@ -19,15 +19,12 @@ On Teams, skip Slack-only tools and the Slack e2e harness. Do not add a CopilotK
 web app to make this run look complete. Do not replace the existing agent.
 
 If repository evidence does not prove an existing valid Intelligence selection, sign in
-yourself with `npx --prefer-offline --yes copilotkit@4.18.0 login --json`: the same single streaming
-session generic onboarding uses. Read its JSON Lines while the process runs. Open the
-first `authentication_url` exactly once with the operating system's default browser
-opener, `open` on macOS, `xdg-open` on Linux, `Start-Process` in Windows PowerShell. Your
-own built-in browser is not that opener and does not carry the session the developer
-already signed in with. If that record carries `user_code`, show the developer the code to
-check against the sign-in page, which works from any device. Never ask the developer to run a login command. If the opener is
-unavailable or fails, show the developer the clickable URL and ask them to finish sign-in
-there, and keep reading the same process. Continue only after that same process emits
+yourself with `npx --prefer-offline --yes copilotkit@4.20.0 login --json`: the same single streaming
+session generic onboarding uses. Read its JSON Lines while the process runs. The CLI opens
+the page itself when it can: with `"browser_opened": false` in `action_required`, show the
+developer the clickable URL and ask them to finish sign-in there. If the record carries
+`user_code`, show the developer the code to check against the page. Never ask the developer
+to run a login command. Keep reading the same process. Continue only after that same process emits
 `type: completed`. Only when it emits `type: failed`, report the error and take the
 feature stop route below. Then list projects and select or create one only after they choose. Require the secret-safe project/key provisioning summary
 before wiring the Channel. Never display a key.
@@ -78,7 +75,7 @@ starter to satisfy this rule, and do not report the page that shows it.
 Before you spawn the implementation subagent, take the authorized list from the CLI:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard audit
+npx --prefer-offline --yes copilotkit@4.20.0 onboard audit
 ```
 
 From its result, copy the paths under `Authorized to modify:`. A passed or failed audit with
@@ -97,7 +94,7 @@ still go on the record. Name the file and why the work needs it, then end your t
 for the developer's answer. If they allow it, record their answer before any edit:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
+npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
 ```
 
 Continue only when the result starts with `Status: passed`. Run the audit again, take the
@@ -109,7 +106,7 @@ feature stop route below.
 After validation and each repair, run:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard audit
+npx --prefer-offline --yes copilotkit@4.20.0 onboard audit
 ```
 
 Continue only when it starts with `Status: passed`. A path under `Authorized to modify:` is
@@ -120,7 +117,7 @@ with the implementation subagent's `Files changed` section. If that section does
 the path, accept the developer's external change:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard protect --accept-external --path <path>
+npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --accept-external --path <path>
 ```
 
 For an env file where the developer placed a requested credential, use
@@ -133,7 +130,7 @@ Run the audit again after each accepted change. If it still fails, or starts
 with `Status: blocked`, route out and stop:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard read feature/stop
+npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/stop
 ```
 
 ## Values this run writes, and the one credential the developer supplies
@@ -166,14 +163,8 @@ both default to 3000, append one line to that env file and change no other line.
 accept it with `onboard protect --accept-credential --path <path>`, which accepts an added
 variable while every recorded one keeps its value, and run the audit again.
 
-When implementation validation passes, report it:
-
-```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard checkpoint --phase build-validated
-```
-
 If validation cannot pass, or this run needs a prerequisite the app does not have, use
 the feature stop route above without further changes.
 
 Otherwise run
-`npx --prefer-offline --yes copilotkit@4.18.0 onboard read feature/channels/proof`.
+`npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/channels/proof`.

package/onboarding/prompts/feature/channels/proof.md

@@ -31,7 +31,7 @@ still go on the record. Name the file and why the fix needs it, then end your tu
 for the developer's answer. If they allow it, record their answer before any edit:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
+npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
 ```
 
 Continue only when the result starts with `Status: passed`. Run the audit again, take the
@@ -40,26 +40,15 @@ same handoff and that list. A subagent that already returned cannot pick up cons
 after it was spawned. If you cannot ask, or the developer declines, take the feature stop
 route below.
 
-Report each attempt at the proof as it ends, counting from one:
+Report the outcome of each attempt as it ends, before any repair. The command counts the
+attempts and the repairs:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard checkpoint --phase journey-attempted --attempt 1
-```
-
-Report each repair cycle the same way, counting from one:
-
-```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard checkpoint --phase repair-attempted --attempt 1
-```
-
-After the final attempt, report the gate exactly once:
-
-```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
+npx --prefer-offline --yes copilotkit@4.20.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
 ```
 
 Use `passed` only for a proved mention reply, `failed` for an attempted proof that
-failed, and `skipped` when the proof did not run. Then run `npx --prefer-offline --yes copilotkit@4.18.0 onboard audit`.
+failed, and `skipped` when the proof did not run. Then run `npx --prefer-offline --yes copilotkit@4.20.0 onboard audit`.
 Continue only when it starts with `Status: passed`.
 
 If the audit fails, never repair, reset, or revert a protected path. Compare each named path
@@ -74,11 +63,11 @@ the path and the change the audit reports. Run the audit again after each accept
 If the audit still fails, or starts with `Status: blocked`, route out and stop:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard read feature/stop
+npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/stop
 ```
 
 When the audit passes and the round trip you reported above was `passed`, run
-`npx --prefer-offline --yes copilotkit@4.18.0 onboard read feature/complete` and complete with
+`npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/complete` and complete with
 `--visual-check channels-proof-passed`. The recorded mention and reply are this run's
 proof, so no web app check is missing. Use `--visual-check performed` only when a
 browser drove Slack or Teams web and proved the mention reply. Do not use

package/onboarding/prompts/feature/channels/start.md

@@ -3,12 +3,14 @@
 First, report your coding agent identity using the same command as generic onboarding:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard identify --coding-agent <coding-agent-slug> --model <model-id>
+npx --prefer-offline --yes copilotkit@4.20.0 onboard identify --coding-agent <coding-agent-slug> --model <model-id> --model-family <model-family>
 ```
 
-Use your own product's slug, such as `codex` or `claude-code`. For `--model`, give the
-exact model id your instructions name. If they name none, leave out `--model` rather than
-guess. This also covers entry commands that omit `--coding-agent`. It needs no login,
+Use your own product's slug, such as `codex` or `claude-code`. For `--model`, copy the
+model id exactly as your instructions write it. If they name no exact model id, leave out
+`--model` rather than guess. For `--model-family`, give the family of the model you run,
+such as `claude-opus` or `gpt-5`, and leave it out if you do not know it. Never give your
+product slug as a model or a family. This also covers entry commands that omit `--coding-agent`. It needs no login,
 browser, or project setup.
 
 Treat Slack or Teams as the UI for this run. A CopilotKit web app is not required.
@@ -32,13 +34,13 @@ carry on. Keep a read-only assignment read-only. If no subagent works at all, re
 once:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard checkpoint --phase delegation-unavailable
+npx --prefer-offline --yes copilotkit@4.20.0 onboard checkpoint --phase delegation-unavailable
 ```
 
 Before you end your turn to wait for the developer, report the pause:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard checkpoint --phase awaiting-developer
+npx --prefer-offline --yes copilotkit@4.20.0 onboard checkpoint --phase awaiting-developer
 ```
 
 A turn that ends while the run waits is a pause, not a stop, even when your harness ends it.
@@ -48,7 +50,7 @@ If you stop this run, send one short report before you stop. The friction comman
 the telemetry setting the developer already chose, so it needs no separate question.
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard friction --phase stop --category <slug> --message "<sentences>"
+npx --prefer-offline --yes copilotkit@4.20.0 onboard friction --phase stop --category <slug> --message "<sentences>"
 ```
 
 `--message` takes one or two sentences: the step you stopped at and what stopped it.
@@ -62,7 +64,7 @@ one scoped fix, and sends the report itself when no fix is approved.
 Before any subagent or project process runs, capture the developer's existing work:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard protect
+npx --prefer-offline --yes copilotkit@4.20.0 onboard protect
 ```
 
 Keep the exact protected path list it prints and give that list to every subagent. Do not
@@ -92,12 +94,9 @@ This one does not.
 Wait for the inspection subagent to finish. Then report that the inspection came back:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard checkpoint --phase research-returned
+npx --prefer-offline --yes copilotkit@4.20.0 onboard checkpoint --phase research-returned
 ```
 
-A refused checkpoint prints its reason and leaves onboarding unaffected. It is not a
-failed step.
-
 If the folder is empty, check Node 22, `uv`, and Python before cloning. Python 3.12 or
 newer satisfies the check. If no Python 3.12 or newer is present and `uv` is, offer once
 to install one with `uv python install 3.12`, and continue after the developer approves.
@@ -109,7 +108,7 @@ and its install command in the message the developer sees: `nvm install 22` for
 for Python. Offer a custom headless build as a later path. Then route out:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard read feature/stop
+npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/stop
 ```
 
 Do not run login, select Intelligence, or create a credential until the developer
@@ -139,17 +138,11 @@ one.
 After approval, record each approved path before implementation:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
+npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
 ```
 
 If an approved path changed after capture and no implementation step has run, add
 `--with-prior-change`. Continue only when every result starts with `Status: passed`. Do not
 authorize a path the approved plan did not list.
 
-Then report the plan this run is about to implement:
-
-```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard checkpoint --phase plan-written
-```
-
-Then run `npx --prefer-offline --yes copilotkit@4.18.0 onboard read feature/channels/implement`.
+Then run `npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/channels/implement`.

package/onboarding/prompts/feature/chat-suggestions/implement.md

@@ -15,7 +15,7 @@ Run focused type/test checks and start the app. Record the changed files and val
 Before you spawn the implementation subagent, take the authorized list from the CLI:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard audit
+npx --prefer-offline --yes copilotkit@4.20.0 onboard audit
 ```
 
 From its result, copy the paths under `Authorized to modify:`. A passed or failed audit with
@@ -34,7 +34,7 @@ still go on the record. Name the file and why the work needs it, then end your t
 for the developer's answer. If they allow it, record their answer before any edit:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
+npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
 ```
 
 Continue only when the result starts with `Status: passed`. Run the audit again, take the
@@ -46,7 +46,7 @@ feature stop route below.
 After validation and each repair, run:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard audit
+npx --prefer-offline --yes copilotkit@4.20.0 onboard audit
 ```
 
 Continue only when it starts with `Status: passed`. A path under `Authorized to modify:` is
@@ -57,7 +57,7 @@ with the implementation subagent's `Files changed` section. If that section does
 the path, accept the developer's external change:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard protect --accept-external --path <path>
+npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --accept-external --path <path>
 ```
 
 For an env file where the developer placed a requested credential, use
@@ -70,17 +70,11 @@ Run the audit again after each accepted change. If it still fails, or starts
 with `Status: blocked`, route out and stop:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard read feature/stop
-```
-
-When implementation validation passes, report it:
-
-```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard checkpoint --phase build-validated
+npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/stop
 ```
 
 If validation cannot pass, or this intent needs a prerequisite the app does not have, use
 the feature stop route above without further changes.
 
 Otherwise run
-`npx --prefer-offline --yes copilotkit@4.18.0 onboard read feature/chat-suggestions/proof`.
+`npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/chat-suggestions/proof`.

package/onboarding/prompts/feature/chat-suggestions/proof.md

@@ -20,7 +20,7 @@ still go on the record. Name the file and why the fix needs it, then end your tu
 for the developer's answer. If they allow it, record their answer before any edit:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
+npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
 ```
 
 Continue only when the result starts with `Status: passed`. Run the audit again, take the
@@ -29,26 +29,15 @@ same handoff and that list. A subagent that already returned cannot pick up cons
 after it was spawned. If you cannot ask, or the developer declines, take the feature stop
 route below.
 
-Report each attempt at the proof as it ends, counting from one:
+Report the outcome of each attempt as it ends, before any repair. The command counts the
+attempts and the repairs:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard checkpoint --phase journey-attempted --attempt 1
-```
-
-Report each repair cycle the same way, counting from one:
-
-```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard checkpoint --phase repair-attempted --attempt 1
-```
-
-After the final attempt, report the gate exactly once:
-
-```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
+npx --prefer-offline --yes copilotkit@4.20.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
 ```
 
 Use `passed` only for a proved sent suggestion, `failed` for an attempted proof that failed,
-and `skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.18.0 onboard audit`.
+and `skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.20.0 onboard audit`.
 Continue only when it starts with `Status: passed`.
 
 If the audit fails, never repair, reset, or revert a protected path. Compare each named path
@@ -63,9 +52,9 @@ the path and the change the audit reports. Run the audit again after each accept
 If the audit still fails, or starts with `Status: blocked`, route out and stop:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard read feature/stop
+npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/stop
 ```
 
 When the audit passes, run
-`npx --prefer-offline --yes copilotkit@4.18.0 onboard read feature/complete` with the real browser-proof
+`npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/complete` with the real browser-proof
 outcome.

package/onboarding/prompts/feature/chat-suggestions/start.md

@@ -19,13 +19,13 @@ carry on. Keep a read-only assignment read-only. If no subagent works at all, re
 once:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard checkpoint --phase delegation-unavailable
+npx --prefer-offline --yes copilotkit@4.20.0 onboard checkpoint --phase delegation-unavailable
 ```
 
 Before you end your turn to wait for the developer, report the pause:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard checkpoint --phase awaiting-developer
+npx --prefer-offline --yes copilotkit@4.20.0 onboard checkpoint --phase awaiting-developer
 ```
 
 A turn that ends while the run waits is a pause, not a stop, even when your harness ends it.
@@ -35,7 +35,7 @@ If you stop this run, send one short report before you stop. The friction comman
 the telemetry setting the developer already chose, so it needs no separate question.
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard friction --phase stop --category <slug> --message "<sentences>"
+npx --prefer-offline --yes copilotkit@4.20.0 onboard friction --phase stop --category <slug> --message "<sentences>"
 ```
 
 `--message` takes one or two sentences: the step you stopped at and what stopped it.
@@ -49,7 +49,7 @@ one scoped fix, and sends the report itself when no fix is approved.
 Before any subagent or project process runs, capture the developer's existing work:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard protect
+npx --prefer-offline --yes copilotkit@4.20.0 onboard protect
 ```
 
 Keep the exact protected path list it prints and give that list to every subagent. No
@@ -58,23 +58,20 @@ approved authorization before implementation.
 
 Before edits, identify the current CopilotKit provider, chat component, message lifecycle,
 agent id, package version, and test/dev commands. Prove the existing OSS round trip with
-`/info`, `npx --prefer-offline --yes copilotkit@4.18.0 verify --expect-runtime oss --round-trip --agent <agent-id> --json`,
+`/info`, `npx --prefer-offline --yes copilotkit@4.20.0 verify --expect-runtime oss --round-trip --agent <agent-id> --json`,
 and one real frontend request when browser control is available.
 
 Wait for the inspection subagent to finish. Then report that the inspection came back:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard checkpoint --phase research-returned
+npx --prefer-offline --yes copilotkit@4.20.0 onboard checkpoint --phase research-returned
 ```
 
-A refused checkpoint prints its reason and leaves onboarding unaffected. It is not a
-failed step.
-
 If the inspection did not prove the baseline this intent extends, stop here without
 changing files:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard read feature/stop
+npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/stop
 ```
 
 Do not run login, provision Intelligence, request a credential, replace the agent, or alter
@@ -96,17 +93,11 @@ one.
 After approval, record each approved path before implementation:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
+npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
 ```
 
 If an approved path changed after capture and no implementation step has run, add
 `--with-prior-change`. Continue only when every result starts with `Status: passed`. Do not
 authorize a path the approved plan did not list.
 
-Then report the plan this run is about to implement:
-
-```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard checkpoint --phase plan-written
-```
-
-Then run `npx --prefer-offline --yes copilotkit@4.18.0 onboard read feature/chat-suggestions/implement`.
+Then run `npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/chat-suggestions/implement`.

package/onboarding/prompts/feature/complete.md

@@ -3,7 +3,7 @@
 Use the outcome the proof step observed. Run:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard complete --visual-check <performed|skipped-no-browser-tool|channels-proof-passed|failed>
+npx --prefer-offline --yes copilotkit@4.20.0 onboard complete --visual-check <performed|skipped-no-browser-tool|channels-proof-passed|failed>
 ```
 
 Use `channels-proof-passed` for a Slack or Teams run that recorded a passed round-trip proof
@@ -14,13 +14,15 @@ Use `performed` only when browser control drove the real user-visible surface. U
 `skipped-no-browser-tool` only when no browser tool was available. Use `failed` when the
 browser proof ran but did not prove the feature.
 
+Paste the **Handoff facts** block the command prints into your summary, as it is.
+
 ## Report friction before completing
 
 Before `onboard complete`, send the friction this run mentioned to the developer, one
 report each, at most four, costliest first:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.18.0 onboard friction --category <slug> --cost-seconds <seconds> --message "<sentences>"
+npx --prefer-offline --yes copilotkit@4.20.0 onboard friction --category <slug> --cost-seconds <seconds> --message "<sentences>"
 ```
 
 Put one or two sentences in `--message`, with no secrets, source, or logs. Pick the