copilotkit 4.19.0 → 4.20.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +18 -9
- package/cli-build-info.json +7 -7
- package/index.js +3127 -2335
- package/onboarding/index.json +1 -1
- package/onboarding/prompts/authenticate/start.md +26 -28
- package/onboarding/prompts/conversion/plan.md +3 -3
- package/onboarding/prompts/credentials/finalize-plan.md +7 -7
- package/onboarding/prompts/credentials/plan.md +22 -22
- package/onboarding/prompts/credentials/settle-credentials.md +7 -5
- package/onboarding/prompts/credentials/write-plan.md +9 -6
- package/onboarding/prompts/fallback/best-effort.md +8 -8
- package/onboarding/prompts/feature/a2ui/implement.md +6 -12
- package/onboarding/prompts/feature/a2ui/proof.md +7 -18
- package/onboarding/prompts/feature/a2ui/start.md +9 -18
- package/onboarding/prompts/feature/channels/implement.md +12 -21
- package/onboarding/prompts/feature/channels/proof.md +7 -18
- package/onboarding/prompts/feature/channels/start.md +14 -21
- package/onboarding/prompts/feature/chat-suggestions/implement.md +6 -12
- package/onboarding/prompts/feature/chat-suggestions/proof.md +7 -18
- package/onboarding/prompts/feature/chat-suggestions/start.md +9 -18
- package/onboarding/prompts/feature/complete.md +4 -2
- package/onboarding/prompts/feature/learning/implement.md +13 -38
- package/onboarding/prompts/feature/learning/proof.md +8 -19
- package/onboarding/prompts/feature/learning/start.md +9 -18
- package/onboarding/prompts/feature/open-generative-ui/implement.md +6 -12
- package/onboarding/prompts/feature/open-generative-ui/proof.md +7 -18
- package/onboarding/prompts/feature/open-generative-ui/start.md +9 -18
- package/onboarding/prompts/feature/realtime-sync/implement.md +7 -13
- package/onboarding/prompts/feature/realtime-sync/proof.md +7 -18
- package/onboarding/prompts/feature/realtime-sync/start.md +8 -17
- package/onboarding/prompts/feature/rich-threads/implement.md +8 -14
- package/onboarding/prompts/feature/rich-threads/proof.md +7 -18
- package/onboarding/prompts/feature/rich-threads/start.md +8 -17
- package/onboarding/prompts/feature/stop.md +3 -3
- package/onboarding/prompts/feature/voice/implement.md +6 -12
- package/onboarding/prompts/feature/voice/proof.md +7 -18
- package/onboarding/prompts/feature/voice/start.md +9 -18
- package/onboarding/prompts/framework/ag2.md +2 -2
- package/onboarding/prompts/framework/agno.md +2 -2
- package/onboarding/prompts/framework/built-in.md +2 -2
- package/onboarding/prompts/framework/claude-sdk-python.md +2 -2
- package/onboarding/prompts/framework/claude-sdk-typescript.md +2 -2
- package/onboarding/prompts/framework/crewai-flows.md +2 -2
- package/onboarding/prompts/framework/deep-agents.md +2 -2
- package/onboarding/prompts/framework/google-adk.md +2 -2
- package/onboarding/prompts/framework/langgraph-fastapi.md +2 -2
- package/onboarding/prompts/framework/langgraph-python.md +2 -2
- package/onboarding/prompts/framework/langgraph-typescript.md +2 -2
- package/onboarding/prompts/framework/llamaindex.md +2 -2
- package/onboarding/prompts/framework/mastra.md +2 -2
- package/onboarding/prompts/framework/ms-agent-dotnet.md +3 -3
- package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +3 -3
- package/onboarding/prompts/framework/ms-agent-python.md +2 -2
- package/onboarding/prompts/framework/pydantic-ai.md +2 -2
- package/onboarding/prompts/framework/strands-python.md +2 -2
- package/onboarding/prompts/framework/strands-typescript.md +2 -2
- package/onboarding/prompts/frontend/angular.md +3 -3
- package/onboarding/prompts/frontend/nextjs.md +3 -3
- package/onboarding/prompts/frontend/plan.md +7 -7
- package/onboarding/prompts/frontend/react-native.md +2 -2
- package/onboarding/prompts/frontend/react-spa.md +2 -2
- package/onboarding/prompts/frontend/vue.md +2 -2
- package/onboarding/prompts/implementation/build-and-validate.md +24 -40
- package/onboarding/prompts/proof/complete.md +86 -204
- package/onboarding/prompts/proof/oss-baseline.md +5 -5
- package/onboarding/prompts/proof/round-trip.md +9 -22
- package/onboarding/prompts/research/gather.md +5 -14
- package/onboarding/prompts/research/merge.md +2 -11
- package/onboarding/prompts/research/preflight.md +2 -8
- package/onboarding/prompts/research/route.md +5 -5
- package/onboarding/prompts/starter/clone.md +5 -15
- package/onboarding/prompts/stopped/run-failed.md +2 -2
- package/onboarding/prompts/subagent/create-plan.md +16 -1
- package/onboarding/prompts/subagent/inspect-repository.md +1 -1
- package/onboarding/prompts/subagent/prove-oss-baseline.md +1 -1
- package/onboarding/prompts/subagent/prove-round-trip.md +28 -20
- package/onboarding/prompts/unsupported/no-validated-path.md +2 -2
- package/package.json +1 -1
- package/release/release-tool.js +1 -1
|
@@ -20,13 +20,13 @@ carry on. Keep a read-only assignment read-only. If no subagent works at all, re
|
|
|
20
20
|
once:
|
|
21
21
|
|
|
22
22
|
```text
|
|
23
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
23
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard checkpoint --phase delegation-unavailable
|
|
24
24
|
```
|
|
25
25
|
|
|
26
26
|
Before you end your turn to wait for the developer, report the pause:
|
|
27
27
|
|
|
28
28
|
```text
|
|
29
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
29
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard checkpoint --phase awaiting-developer
|
|
30
30
|
```
|
|
31
31
|
|
|
32
32
|
A turn that ends while the run waits is a pause, not a stop, even when your harness ends it.
|
|
@@ -36,7 +36,7 @@ If you stop this run, send one short report before you stop. The friction comman
|
|
|
36
36
|
the telemetry setting the developer already chose, so it needs no separate question.
|
|
37
37
|
|
|
38
38
|
```text
|
|
39
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
39
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard friction --phase stop --category <slug> --message "<sentences>"
|
|
40
40
|
```
|
|
41
41
|
|
|
42
42
|
`--message` takes one or two sentences: the step you stopped at and what stopped it.
|
|
@@ -66,7 +66,7 @@ status:
|
|
|
66
66
|
before the capture, the inspection, and any edit:
|
|
67
67
|
|
|
68
68
|
```text
|
|
69
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
69
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/blocked-by-plan
|
|
70
70
|
```
|
|
71
71
|
|
|
72
72
|
- `LEARNING_AVAILABILITY_UNAVAILABLE` means the platform did not resolve the answer. It is
|
|
@@ -87,7 +87,7 @@ again: it has no answer, so it carries the question forward rather than ending o
|
|
|
87
87
|
Before any subagent or project process runs, capture the developer's existing work:
|
|
88
88
|
|
|
89
89
|
```text
|
|
90
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
90
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard protect
|
|
91
91
|
```
|
|
92
92
|
|
|
93
93
|
Keep the exact protected path list it prints and give that list to every subagent. No
|
|
@@ -101,17 +101,14 @@ test/dev commands. Prove the current round trip and inspect `/info`.
|
|
|
101
101
|
Wait for the inspection subagent to finish. Then report that the inspection came back:
|
|
102
102
|
|
|
103
103
|
```text
|
|
104
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
104
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard checkpoint --phase research-returned
|
|
105
105
|
```
|
|
106
106
|
|
|
107
|
-
A refused checkpoint prints its reason and leaves onboarding unaffected. It is not a
|
|
108
|
-
failed step.
|
|
109
|
-
|
|
110
107
|
If the inspection did not prove the baseline this intent extends, stop here without
|
|
111
108
|
changing files:
|
|
112
109
|
|
|
113
110
|
```text
|
|
114
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
111
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/stop
|
|
115
112
|
```
|
|
116
113
|
|
|
117
114
|
Fetch the current official guides before planning:
|
|
@@ -143,17 +140,11 @@ one.
|
|
|
143
140
|
After approval, record each approved path before implementation:
|
|
144
141
|
|
|
145
142
|
```text
|
|
146
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
143
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
|
|
147
144
|
```
|
|
148
145
|
|
|
149
146
|
If an approved path changed after capture and no implementation step has run, add
|
|
150
147
|
`--with-prior-change`. Continue only when every result starts with `Status: passed`. Do not
|
|
151
148
|
authorize a path the approved plan did not list.
|
|
152
149
|
|
|
153
|
-
Then
|
|
154
|
-
|
|
155
|
-
```text
|
|
156
|
-
npx --prefer-offline --yes copilotkit@4.19.0 onboard checkpoint --phase plan-written
|
|
157
|
-
```
|
|
158
|
-
|
|
159
|
-
Then run `npx --prefer-offline --yes copilotkit@4.19.0 onboard read feature/learning/implement`.
|
|
150
|
+
Then run `npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/learning/implement`.
|
|
@@ -16,7 +16,7 @@ validation results without secrets.
|
|
|
16
16
|
Before you spawn the implementation subagent, take the authorized list from the CLI:
|
|
17
17
|
|
|
18
18
|
```text
|
|
19
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
19
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard audit
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
From its result, copy the paths under `Authorized to modify:`. A passed or failed audit with
|
|
@@ -35,7 +35,7 @@ still go on the record. Name the file and why the work needs it, then end your t
|
|
|
35
35
|
for the developer's answer. If they allow it, record their answer before any edit:
|
|
36
36
|
|
|
37
37
|
```text
|
|
38
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
38
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
39
39
|
```
|
|
40
40
|
|
|
41
41
|
Continue only when the result starts with `Status: passed`. Run the audit again, take the
|
|
@@ -47,7 +47,7 @@ feature stop route below.
|
|
|
47
47
|
After validation and each repair, run:
|
|
48
48
|
|
|
49
49
|
```text
|
|
50
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
50
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard audit
|
|
51
51
|
```
|
|
52
52
|
|
|
53
53
|
Continue only when it starts with `Status: passed`. A path under `Authorized to modify:` is
|
|
@@ -58,7 +58,7 @@ with the implementation subagent's `Files changed` section. If that section does
|
|
|
58
58
|
the path, accept the developer's external change:
|
|
59
59
|
|
|
60
60
|
```text
|
|
61
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
61
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --accept-external --path <path>
|
|
62
62
|
```
|
|
63
63
|
|
|
64
64
|
For an env file where the developer placed a requested credential, use
|
|
@@ -71,17 +71,11 @@ Run the audit again after each accepted change. If it still fails, or starts
|
|
|
71
71
|
with `Status: blocked`, route out and stop:
|
|
72
72
|
|
|
73
73
|
```text
|
|
74
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
When implementation validation passes, report it:
|
|
78
|
-
|
|
79
|
-
```text
|
|
80
|
-
npx --prefer-offline --yes copilotkit@4.19.0 onboard checkpoint --phase build-validated
|
|
74
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/stop
|
|
81
75
|
```
|
|
82
76
|
|
|
83
77
|
If validation cannot pass, or this intent needs a prerequisite the app does not have, use
|
|
84
78
|
the feature stop route above without further changes.
|
|
85
79
|
|
|
86
80
|
Otherwise run
|
|
87
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
81
|
+
`npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/open-generative-ui/proof`.
|
|
@@ -21,7 +21,7 @@ still go on the record. Name the file and why the fix needs it, then end your tu
|
|
|
21
21
|
for the developer's answer. If they allow it, record their answer before any edit:
|
|
22
22
|
|
|
23
23
|
```text
|
|
24
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
24
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
25
25
|
```
|
|
26
26
|
|
|
27
27
|
Continue only when the result starts with `Status: passed`. Run the audit again, take the
|
|
@@ -30,26 +30,15 @@ same handoff and that list. A subagent that already returned cannot pick up cons
|
|
|
30
30
|
after it was spawned. If you cannot ask, or the developer declines, take the feature stop
|
|
31
31
|
route below.
|
|
32
32
|
|
|
33
|
-
Report
|
|
33
|
+
Report the outcome of each attempt as it ends, before any repair. The command counts the
|
|
34
|
+
attempts and the repairs:
|
|
34
35
|
|
|
35
36
|
```text
|
|
36
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
Report each repair cycle the same way, counting from one:
|
|
40
|
-
|
|
41
|
-
```text
|
|
42
|
-
npx --prefer-offline --yes copilotkit@4.19.0 onboard checkpoint --phase repair-attempted --attempt 1
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
After the final attempt, report the gate exactly once:
|
|
46
|
-
|
|
47
|
-
```text
|
|
48
|
-
npx --prefer-offline --yes copilotkit@4.19.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
|
|
37
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
|
|
49
38
|
```
|
|
50
39
|
|
|
51
40
|
Use `passed` only for a proved generated UI, `failed` for an attempted proof that failed,
|
|
52
|
-
and `skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.
|
|
41
|
+
and `skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.20.0 onboard audit`.
|
|
53
42
|
Continue only when it starts with `Status: passed`.
|
|
54
43
|
|
|
55
44
|
If the audit fails, never repair, reset, or revert a protected path. Compare each named path
|
|
@@ -64,9 +53,9 @@ the path and the change the audit reports. Run the audit again after each accept
|
|
|
64
53
|
If the audit still fails, or starts with `Status: blocked`, route out and stop:
|
|
65
54
|
|
|
66
55
|
```text
|
|
67
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
56
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/stop
|
|
68
57
|
```
|
|
69
58
|
|
|
70
59
|
When the audit passes, run
|
|
71
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
60
|
+
`npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/complete` with the outcome actually
|
|
72
61
|
observed.
|
|
@@ -19,13 +19,13 @@ carry on. Keep a read-only assignment read-only. If no subagent works at all, re
|
|
|
19
19
|
once:
|
|
20
20
|
|
|
21
21
|
```text
|
|
22
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
22
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard checkpoint --phase delegation-unavailable
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
Before you end your turn to wait for the developer, report the pause:
|
|
26
26
|
|
|
27
27
|
```text
|
|
28
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
28
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard checkpoint --phase awaiting-developer
|
|
29
29
|
```
|
|
30
30
|
|
|
31
31
|
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
|
|
|
35
35
|
the telemetry setting the developer already chose, so it needs no separate question.
|
|
36
36
|
|
|
37
37
|
```text
|
|
38
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
38
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard friction --phase stop --category <slug> --message "<sentences>"
|
|
39
39
|
```
|
|
40
40
|
|
|
41
41
|
`--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.
|
|
|
49
49
|
Before any subagent or project process runs, capture the developer's existing work:
|
|
50
50
|
|
|
51
51
|
```text
|
|
52
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
52
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard protect
|
|
53
53
|
```
|
|
54
54
|
|
|
55
55
|
Keep the exact protected path list it prints and give that list to every subagent. No
|
|
@@ -59,23 +59,20 @@ approved authorization before implementation.
|
|
|
59
59
|
Before edits, have a research subagent identify the current CopilotKit runtime route,
|
|
60
60
|
provider/chat component, agent id, package versions, existing middleware, sandbox/CSP
|
|
61
61
|
constraints, and normal test/dev commands. Prove the existing app first with `/info`,
|
|
62
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
62
|
+
`npx --prefer-offline --yes copilotkit@4.20.0 verify --expect-runtime oss --round-trip --agent <agent-id> --json`,
|
|
63
63
|
and a real frontend request when browser control is available.
|
|
64
64
|
|
|
65
65
|
Wait for the inspection subagent to finish. Then report that the inspection came back:
|
|
66
66
|
|
|
67
67
|
```text
|
|
68
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
68
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard checkpoint --phase research-returned
|
|
69
69
|
```
|
|
70
70
|
|
|
71
|
-
A refused checkpoint prints its reason and leaves onboarding unaffected. It is not a
|
|
72
|
-
failed step.
|
|
73
|
-
|
|
74
71
|
If the inspection did not prove the baseline this intent extends, stop here without
|
|
75
72
|
changing files:
|
|
76
73
|
|
|
77
74
|
```text
|
|
78
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
75
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/stop
|
|
79
76
|
```
|
|
80
77
|
|
|
81
78
|
Do not sign in, select an Intelligence project, create credentials, change the existing
|
|
@@ -97,17 +94,11 @@ one.
|
|
|
97
94
|
After approval, record each approved path before implementation:
|
|
98
95
|
|
|
99
96
|
```text
|
|
100
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
97
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
|
|
101
98
|
```
|
|
102
99
|
|
|
103
100
|
If an approved path changed after capture and no implementation step has run, add
|
|
104
101
|
`--with-prior-change`. Continue only when every result starts with `Status: passed`. Do not
|
|
105
102
|
authorize a path the approved plan did not list.
|
|
106
103
|
|
|
107
|
-
Then
|
|
108
|
-
|
|
109
|
-
```text
|
|
110
|
-
npx --prefer-offline --yes copilotkit@4.19.0 onboard checkpoint --phase plan-written
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
Then run `npx --prefer-offline --yes copilotkit@4.19.0 onboard read feature/open-generative-ui/implement`.
|
|
104
|
+
Then run `npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/open-generative-ui/implement`.
|
|
@@ -17,14 +17,14 @@ non-zero on an app that is working. Pass what `identifyUser` reads with a repeat
|
|
|
17
17
|
It is not a defect to repair.
|
|
18
18
|
|
|
19
19
|
Run focused tests and
|
|
20
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
20
|
+
`npx --prefer-offline --yes copilotkit@4.20.0 verify --expect-runtime intelligence --round-trip --agent <agent-id> --json`.
|
|
21
21
|
Repair changed-file failures and record changed paths and secret-safe validation
|
|
22
22
|
evidence.
|
|
23
23
|
|
|
24
24
|
Before you spawn the implementation subagent, take the authorized list from the CLI:
|
|
25
25
|
|
|
26
26
|
```text
|
|
27
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
27
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard audit
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
From its result, copy the paths under `Authorized to modify:`. A passed or failed audit with
|
|
@@ -43,7 +43,7 @@ still go on the record. Name the file and why the work needs it, then end your t
|
|
|
43
43
|
for the developer's answer. If they allow it, record their answer before any edit:
|
|
44
44
|
|
|
45
45
|
```text
|
|
46
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
46
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
Continue only when the result starts with `Status: passed`. Run the audit again, take the
|
|
@@ -55,7 +55,7 @@ feature stop route below.
|
|
|
55
55
|
After validation and each repair, run:
|
|
56
56
|
|
|
57
57
|
```text
|
|
58
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
58
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard audit
|
|
59
59
|
```
|
|
60
60
|
|
|
61
61
|
Continue only when it starts with `Status: passed`. A path under `Authorized to modify:` is
|
|
@@ -66,7 +66,7 @@ with the implementation subagent's `Files changed` section. If that section does
|
|
|
66
66
|
the path, accept the developer's external change:
|
|
67
67
|
|
|
68
68
|
```text
|
|
69
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
69
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --accept-external --path <path>
|
|
70
70
|
```
|
|
71
71
|
|
|
72
72
|
For an env file where the developer placed a requested credential, use
|
|
@@ -79,17 +79,11 @@ Run the audit again after each accepted change. If it still fails, or starts
|
|
|
79
79
|
with `Status: blocked`, route out and stop:
|
|
80
80
|
|
|
81
81
|
```text
|
|
82
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
83
|
-
```
|
|
84
|
-
|
|
85
|
-
When implementation validation passes, report it:
|
|
86
|
-
|
|
87
|
-
```text
|
|
88
|
-
npx --prefer-offline --yes copilotkit@4.19.0 onboard checkpoint --phase build-validated
|
|
82
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/stop
|
|
89
83
|
```
|
|
90
84
|
|
|
91
85
|
If validation cannot pass, or this intent needs a prerequisite the app does not have, use
|
|
92
86
|
the feature stop route above without further changes.
|
|
93
87
|
|
|
94
88
|
Otherwise run
|
|
95
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
89
|
+
`npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/realtime-sync/proof`.
|
|
@@ -23,7 +23,7 @@ still go on the record. Name the file and why the fix needs it, then end your tu
|
|
|
23
23
|
for the developer's answer. If they allow it, record their answer before any edit:
|
|
24
24
|
|
|
25
25
|
```text
|
|
26
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
26
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
27
27
|
```
|
|
28
28
|
|
|
29
29
|
Continue only when the result starts with `Status: passed`. Run the audit again, take the
|
|
@@ -32,26 +32,15 @@ same handoff and that list. A subagent that already returned cannot pick up cons
|
|
|
32
32
|
after it was spawned. If you cannot ask, or the developer declines, take the feature stop
|
|
33
33
|
route below.
|
|
34
34
|
|
|
35
|
-
Report
|
|
35
|
+
Report the outcome of each attempt as it ends, before any repair. The command counts the
|
|
36
|
+
attempts and the repairs:
|
|
36
37
|
|
|
37
38
|
```text
|
|
38
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
Report each repair cycle the same way, counting from one:
|
|
42
|
-
|
|
43
|
-
```text
|
|
44
|
-
npx --prefer-offline --yes copilotkit@4.19.0 onboard checkpoint --phase repair-attempted --attempt 1
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
After the final attempt, report the gate exactly once:
|
|
48
|
-
|
|
49
|
-
```text
|
|
50
|
-
npx --prefer-offline --yes copilotkit@4.19.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
|
|
39
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
|
|
51
40
|
```
|
|
52
41
|
|
|
53
42
|
Use `passed` only for proved two-client sync, `failed` for an attempted proof that failed,
|
|
54
|
-
and `skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.
|
|
43
|
+
and `skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.20.0 onboard audit`.
|
|
55
44
|
Continue only when it starts with `Status: passed`.
|
|
56
45
|
|
|
57
46
|
If the audit fails, never repair, reset, or revert a protected path. Compare each named path
|
|
@@ -66,8 +55,8 @@ the path and the change the audit reports. Run the audit again after each accept
|
|
|
66
55
|
If the audit still fails, or starts with `Status: blocked`, route out and stop:
|
|
67
56
|
|
|
68
57
|
```text
|
|
69
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
58
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/stop
|
|
70
59
|
```
|
|
71
60
|
|
|
72
61
|
When the audit passes, run
|
|
73
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
62
|
+
`npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/complete` with the actual outcome.
|
|
@@ -20,13 +20,13 @@ carry on. Keep a read-only assignment read-only. If no subagent works at all, re
|
|
|
20
20
|
once:
|
|
21
21
|
|
|
22
22
|
```text
|
|
23
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
23
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard checkpoint --phase delegation-unavailable
|
|
24
24
|
```
|
|
25
25
|
|
|
26
26
|
Before you end your turn to wait for the developer, report the pause:
|
|
27
27
|
|
|
28
28
|
```text
|
|
29
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
29
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard checkpoint --phase awaiting-developer
|
|
30
30
|
```
|
|
31
31
|
|
|
32
32
|
A turn that ends while the run waits is a pause, not a stop, even when your harness ends it.
|
|
@@ -36,7 +36,7 @@ If you stop this run, send one short report before you stop. The friction comman
|
|
|
36
36
|
the telemetry setting the developer already chose, so it needs no separate question.
|
|
37
37
|
|
|
38
38
|
```text
|
|
39
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
39
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard friction --phase stop --category <slug> --message "<sentences>"
|
|
40
40
|
```
|
|
41
41
|
|
|
42
42
|
`--message` takes one or two sentences: the step you stopped at and what stopped it.
|
|
@@ -50,7 +50,7 @@ one scoped fix, and sends the report itself when no fix is approved.
|
|
|
50
50
|
Before any subagent or project process runs, capture the developer's existing work:
|
|
51
51
|
|
|
52
52
|
```text
|
|
53
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
53
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard protect
|
|
54
54
|
```
|
|
55
55
|
|
|
56
56
|
Keep the exact protected path list it prints and give that list to every subagent. No
|
|
@@ -65,17 +65,14 @@ round trip and inspect `/info`.
|
|
|
65
65
|
Wait for the inspection subagent to finish. Then report that the inspection came back:
|
|
66
66
|
|
|
67
67
|
```text
|
|
68
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
68
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard checkpoint --phase research-returned
|
|
69
69
|
```
|
|
70
70
|
|
|
71
|
-
A refused checkpoint prints its reason and leaves onboarding unaffected. It is not a
|
|
72
|
-
failed step.
|
|
73
|
-
|
|
74
71
|
If the inspection did not prove the baseline this intent extends, stop here without
|
|
75
72
|
changing files:
|
|
76
73
|
|
|
77
74
|
```text
|
|
78
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
75
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/stop
|
|
79
76
|
```
|
|
80
77
|
|
|
81
78
|
Fetch the current official guides before planning:
|
|
@@ -101,17 +98,11 @@ one.
|
|
|
101
98
|
After approval, record each approved path before implementation:
|
|
102
99
|
|
|
103
100
|
```text
|
|
104
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
101
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
|
|
105
102
|
```
|
|
106
103
|
|
|
107
104
|
If an approved path changed after capture and no implementation step has run, add
|
|
108
105
|
`--with-prior-change`. Continue only when every result starts with `Status: passed`. Do not
|
|
109
106
|
authorize a path the approved plan did not list.
|
|
110
107
|
|
|
111
|
-
Then
|
|
112
|
-
|
|
113
|
-
```text
|
|
114
|
-
npx --prefer-offline --yes copilotkit@4.19.0 onboard checkpoint --phase plan-written
|
|
115
|
-
```
|
|
116
|
-
|
|
117
|
-
Then run `npx --prefer-offline --yes copilotkit@4.19.0 onboard read feature/realtime-sync/implement`.
|
|
108
|
+
Then run `npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/realtime-sync/implement`.
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Delegate implementation to one subagent with the approved plan and fetched official guides.
|
|
4
4
|
If repository evidence does not prove an existing valid Intelligence selection, run
|
|
5
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
5
|
+
`npx --prefer-offline --yes copilotkit@4.20.0 login --json` and follow its single streaming session. Then
|
|
6
6
|
list projects, show the developer the current/recent choices, and select or create one only
|
|
7
7
|
after they choose. Require the secret-safe selection summary to confirm the project file,
|
|
8
8
|
environment file, and key provisioning; never display a key. If existing configuration is
|
|
@@ -20,14 +20,14 @@ non-zero on an app that is working. Pass what `identifyUser` reads with a repeat
|
|
|
20
20
|
It is not a defect to repair.
|
|
21
21
|
|
|
22
22
|
Run focused type/test commands, then start the app and run
|
|
23
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
23
|
+
`npx --prefer-offline --yes copilotkit@4.20.0 verify --expect-runtime intelligence --round-trip --agent <agent-id> --json`.
|
|
24
24
|
Repair changed-file failures before continuing. Record changed paths and secret-safe
|
|
25
25
|
validation evidence.
|
|
26
26
|
|
|
27
27
|
Before you spawn the implementation subagent, take the authorized list from the CLI:
|
|
28
28
|
|
|
29
29
|
```text
|
|
30
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
30
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard audit
|
|
31
31
|
```
|
|
32
32
|
|
|
33
33
|
From its result, copy the paths under `Authorized to modify:`. A passed or failed audit with
|
|
@@ -46,7 +46,7 @@ still go on the record. Name the file and why the work needs it, then end your t
|
|
|
46
46
|
for the developer's answer. If they allow it, record their answer before any edit:
|
|
47
47
|
|
|
48
48
|
```text
|
|
49
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
49
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
50
50
|
```
|
|
51
51
|
|
|
52
52
|
Continue only when the result starts with `Status: passed`. Run the audit again, take the
|
|
@@ -58,7 +58,7 @@ feature stop route below.
|
|
|
58
58
|
After validation and each repair, run:
|
|
59
59
|
|
|
60
60
|
```text
|
|
61
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
61
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard audit
|
|
62
62
|
```
|
|
63
63
|
|
|
64
64
|
Continue only when it starts with `Status: passed`. A path under `Authorized to modify:` is
|
|
@@ -69,7 +69,7 @@ with the implementation subagent's `Files changed` section. If that section does
|
|
|
69
69
|
the path, accept the developer's external change:
|
|
70
70
|
|
|
71
71
|
```text
|
|
72
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
72
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --accept-external --path <path>
|
|
73
73
|
```
|
|
74
74
|
|
|
75
75
|
For an env file where the developer placed a requested credential, use
|
|
@@ -82,17 +82,11 @@ Run the audit again after each accepted change. If it still fails, or starts
|
|
|
82
82
|
with `Status: blocked`, route out and stop:
|
|
83
83
|
|
|
84
84
|
```text
|
|
85
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
86
|
-
```
|
|
87
|
-
|
|
88
|
-
When implementation validation passes, report it:
|
|
89
|
-
|
|
90
|
-
```text
|
|
91
|
-
npx --prefer-offline --yes copilotkit@4.19.0 onboard checkpoint --phase build-validated
|
|
85
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/stop
|
|
92
86
|
```
|
|
93
87
|
|
|
94
88
|
If validation cannot pass, or this intent needs a prerequisite the app does not have, use
|
|
95
89
|
the feature stop route above without further changes.
|
|
96
90
|
|
|
97
91
|
Otherwise run
|
|
98
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
92
|
+
`npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/rich-threads/proof`.
|
|
@@ -22,7 +22,7 @@ still go on the record. Name the file and why the fix needs it, then end your tu
|
|
|
22
22
|
for the developer's answer. If they allow it, record their answer before any edit:
|
|
23
23
|
|
|
24
24
|
```text
|
|
25
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
25
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
26
26
|
```
|
|
27
27
|
|
|
28
28
|
Continue only when the result starts with `Status: passed`. Run the audit again, take the
|
|
@@ -31,27 +31,16 @@ same handoff and that list. A subagent that already returned cannot pick up cons
|
|
|
31
31
|
after it was spawned. If you cannot ask, or the developer declines, take the feature stop
|
|
32
32
|
route below.
|
|
33
33
|
|
|
34
|
-
Report
|
|
34
|
+
Report the outcome of each attempt as it ends, before any repair. The command counts the
|
|
35
|
+
attempts and the repairs:
|
|
35
36
|
|
|
36
37
|
```text
|
|
37
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
Report each repair cycle the same way, counting from one:
|
|
41
|
-
|
|
42
|
-
```text
|
|
43
|
-
npx --prefer-offline --yes copilotkit@4.19.0 onboard checkpoint --phase repair-attempted --attempt 1
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
After the final attempt, report the gate exactly once:
|
|
47
|
-
|
|
48
|
-
```text
|
|
49
|
-
npx --prefer-offline --yes copilotkit@4.19.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
|
|
38
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
|
|
50
39
|
```
|
|
51
40
|
|
|
52
41
|
Use `passed` only for proved persistence and reopen, `failed` for an attempted proof that
|
|
53
42
|
failed, and `skipped` when the proof could not run. Then run
|
|
54
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
43
|
+
`npx --prefer-offline --yes copilotkit@4.20.0 onboard audit`. Continue only when it starts with
|
|
55
44
|
`Status: passed`.
|
|
56
45
|
|
|
57
46
|
If the audit fails, never repair, reset, or revert a protected path. Compare each named path
|
|
@@ -66,9 +55,9 @@ the path and the change the audit reports. Run the audit again after each accept
|
|
|
66
55
|
If the audit still fails, or starts with `Status: blocked`, route out and stop:
|
|
67
56
|
|
|
68
57
|
```text
|
|
69
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
58
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/stop
|
|
70
59
|
```
|
|
71
60
|
|
|
72
61
|
When the audit passes, run
|
|
73
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
62
|
+
`npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/complete` with the actual browser
|
|
74
63
|
outcome.
|
|
@@ -20,13 +20,13 @@ carry on. Keep a read-only assignment read-only. If no subagent works at all, re
|
|
|
20
20
|
once:
|
|
21
21
|
|
|
22
22
|
```text
|
|
23
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
23
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard checkpoint --phase delegation-unavailable
|
|
24
24
|
```
|
|
25
25
|
|
|
26
26
|
Before you end your turn to wait for the developer, report the pause:
|
|
27
27
|
|
|
28
28
|
```text
|
|
29
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
29
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard checkpoint --phase awaiting-developer
|
|
30
30
|
```
|
|
31
31
|
|
|
32
32
|
A turn that ends while the run waits is a pause, not a stop, even when your harness ends it.
|
|
@@ -36,7 +36,7 @@ If you stop this run, send one short report before you stop. The friction comman
|
|
|
36
36
|
the telemetry setting the developer already chose, so it needs no separate question.
|
|
37
37
|
|
|
38
38
|
```text
|
|
39
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
39
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard friction --phase stop --category <slug> --message "<sentences>"
|
|
40
40
|
```
|
|
41
41
|
|
|
42
42
|
`--message` takes one or two sentences: the step you stopped at and what stopped it.
|
|
@@ -50,7 +50,7 @@ one scoped fix, and sends the report itself when no fix is approved.
|
|
|
50
50
|
Before any subagent or project process runs, capture the developer's existing work:
|
|
51
51
|
|
|
52
52
|
```text
|
|
53
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
53
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard protect
|
|
54
54
|
```
|
|
55
55
|
|
|
56
56
|
Keep the exact protected path list it prints and give that list to every subagent. No
|
|
@@ -65,17 +65,14 @@ the current frontend-to-runtime-to-agent round trip and inspect `/info`.
|
|
|
65
65
|
Wait for the inspection subagent to finish. Then report that the inspection came back:
|
|
66
66
|
|
|
67
67
|
```text
|
|
68
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
68
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard checkpoint --phase research-returned
|
|
69
69
|
```
|
|
70
70
|
|
|
71
|
-
A refused checkpoint prints its reason and leaves onboarding unaffected. It is not a
|
|
72
|
-
failed step.
|
|
73
|
-
|
|
74
71
|
If the inspection did not prove the baseline this intent extends, stop here without
|
|
75
72
|
changing files:
|
|
76
73
|
|
|
77
74
|
```text
|
|
78
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
75
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/stop
|
|
79
76
|
```
|
|
80
77
|
|
|
81
78
|
Fetch the current official guides before planning:
|
|
@@ -103,17 +100,11 @@ one.
|
|
|
103
100
|
After approval, record each approved path before implementation:
|
|
104
101
|
|
|
105
102
|
```text
|
|
106
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
103
|
+
npx --prefer-offline --yes copilotkit@4.20.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
|
|
107
104
|
```
|
|
108
105
|
|
|
109
106
|
If an approved path changed after capture and no implementation step has run, add
|
|
110
107
|
`--with-prior-change`. Continue only when every result starts with `Status: passed`. Do not
|
|
111
108
|
authorize a path the approved plan did not list.
|
|
112
109
|
|
|
113
|
-
Then
|
|
114
|
-
|
|
115
|
-
```text
|
|
116
|
-
npx --prefer-offline --yes copilotkit@4.19.0 onboard checkpoint --phase plan-written
|
|
117
|
-
```
|
|
118
|
-
|
|
119
|
-
Then run `npx --prefer-offline --yes copilotkit@4.19.0 onboard read feature/rich-threads/implement`.
|
|
110
|
+
Then run `npx --prefer-offline --yes copilotkit@4.20.0 onboard read feature/rich-threads/implement`.
|