overlord-cli 5.3.0 → 5.4.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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "overlord-cli",
3
- "version": "5.3.0",
3
+ "version": "5.4.0",
4
4
  "description": "Overlord CLI — launch AI agents on tickets from anywhere",
5
5
  "type": "module",
6
6
  "bin": {
@@ -127,6 +127,15 @@ ovld protocol discover-project
127
127
 
128
128
  You can override with `--project-id` or `--working-directory` if needed.
129
129
 
130
+ ### Choosing `--execution-target`
131
+
132
+ Pass `--execution-target agent` or `--execution-target human` (default: `human`) when creating tickets.
133
+
134
+ - **`agent`** — any task an AI agent can complete in a computer environment: coding, internet research, document editing, data analysis, automated testing, etc.
135
+ - **`human`** — any task requiring human presence or judgment: setting credentials or tokens in a third-party UI (e.g. Vercel, AWS), sending physical mail, making a product or business decision, physical-world actions.
136
+
137
+ When in doubt, ask yourself: *can this be done entirely inside a terminal or browser by an AI without human intervention?* If yes → `agent`. If it requires a human to log in, decide, or act in the real world → `human`.
138
+
130
139
  ## Context And Artifacts
131
140
 
132
141
  ```bash
@@ -145,3 +154,5 @@ ovld protocol artifact-download-url --session-key <sessionKey> --ticket-id $TICK
145
154
  - Use `write-context` for facts a future agent session should know.
146
155
  - Do not add or commit changes unless the user explicitly asks you to commit.
147
156
  - Delivery is the concluding step. After delivering, stop unless the user follows up or the ticket is reopened.
157
+
158
+ <!-- version: 0.2.2 -->
@@ -27,9 +27,21 @@ Use this skill whenever Cursor needs to work with Overlord, whether the session
27
27
  6. If you need other lifecycle commands or flags, run `ovld protocol help` and use the real subcommand list instead of guessing.
28
28
  7. Once you attach to a ticket, switch back to Mode 1 and follow the full ticket lifecycle.
29
29
 
30
+ ## Choosing `--execution-target` When Creating Tickets
31
+
32
+ Pass `--execution-target agent` or `--execution-target human` (default: `human`) when creating tickets.
33
+
34
+ - **`agent`** — any task an AI agent can complete in a computer environment: coding, internet research, document editing, data analysis, automated testing, etc.
35
+ - **`human`** — any task requiring human presence or judgment: setting credentials or tokens in a third-party UI (e.g. Vercel, AWS), sending physical mail, making a product or business decision, physical-world actions.
36
+
37
+ When in doubt, ask yourself: *can this be done entirely inside a terminal or browser by an AI without human intervention?* If yes → `agent`. If it requires a human to log in, decide, or act in the real world → `human`.
38
+
30
39
  ## Rules
31
40
 
32
41
  - Always attach first and always deliver last once you are on a ticket.
33
42
  - Use `ovld protocol` commands, the plugin commands, and the MCP tool instead of ad hoc scripts.
34
43
  - Do not invent protocol subcommands. Use `ovld protocol help` when unsure.
35
44
  - Include at least one progress update before delivering.
45
+ - When creating follow-up tickets, always set `--execution-target` explicitly using the `agent`/`human` rule above.
46
+
47
+ <!-- version: 0.2.2 -->
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "overlord",
3
- "version": "0.1.0",
3
+ "version": "0.2.0",
4
4
  "description": "Chat-driven access to Overlord ticket protocol workflows.",
5
5
  "author": {
6
6
  "name": "Cooperativ",
@@ -23,9 +23,9 @@
23
23
  "privacyPolicyURL": "https://www.ovld.ai/privacy",
24
24
  "termsOfServiceURL": "https://www.ovld.ai/terms",
25
25
  "defaultPrompt": [
26
- "Attach to Overlord ticket 123 and summarize the context before editing code",
27
- "Post an execute update to this Overlord ticket after a meaningful implementation step",
28
- "Deliver this Overlord ticket with artifacts and change rationales"
26
+ "Create an Overlord ticket with the objective 'Implement feature X' and summarize the context before editing code",
27
+ "Execute Overlord ticket [ticket-id]",
28
+ "Find all Overlord tickets with the status 'next-up' and prioritize the most important one"
29
29
  ],
30
30
  "brandColor": "#1E6B5C",
31
31
  "composerIcon": "./assets/icon.png",
@@ -121,6 +121,15 @@ ovld protocol create --agent codex --objective "Capture follow-up work from this
121
121
  ovld protocol spawn --agent codex --objective "Implement feature X" --priority medium
122
122
  ```
123
123
 
124
+ ### Choosing `--execution-target`
125
+
126
+ Pass `--execution-target agent` or `--execution-target human` (default: `human`) when creating tickets.
127
+
128
+ - **`agent`** — any task an AI agent can complete in a computer environment: coding, internet research, document editing, data analysis, automated testing, etc.
129
+ - **`human`** — any task requiring human presence or judgment: setting credentials or tokens in a third-party UI (e.g. Vercel, AWS), sending physical mail, making a product or business decision, physical-world actions.
130
+
131
+ When in doubt, ask yourself: *can this be done entirely inside a terminal or browser by an AI without human intervention?* If yes → `agent`. If it requires a human to log in, decide, or act in the real world → `human`.
132
+
124
133
  ## Rules
125
134
 
126
135
  - The authoritative lifecycle is the `ovld protocol` CLI once you are on a ticket.
@@ -128,3 +137,5 @@ ovld protocol spawn --agent codex --objective "Implement feature X" --priority m
128
137
  - Prefer the installed `ovld` CLI and the plugin's MCP tools instead of ad hoc repo scripts.
129
138
  - Do not create or rely on a local Codex `AGENTS.md` bundle for Overlord.
130
139
  - When the ticket was launched by Overlord, the ticket prompt remains authoritative for the specific task objective and ticket-level constraints.
140
+
141
+ <!-- version: 0.2.2 -->