overlord-cli 0.2605241431.0 → 0.2605241542.0

package/bin/_cli/new-ticket.mjs

@@ -48,10 +48,25 @@ function parseFlags(args) {
 
 function buildUsage(commandName) {
   if (commandName === 'prompt') {
-    return 'Usage: ovld prompt --objectives-json \'[{"objective":"..."}]\' [--objectives-file <path>] [--title "..."] [--acceptance-criteria "..."] [--available-tools "..."] [--execution-target agent|human] [--priority low|medium|high|urgent] [--project-id <id>] [--agent <agent>] [--model <identifier>] [--delegate <agent>]';
+    return 'Usage: ovld prompt --objectives-json \'[{"objective":"..."}]\' [--objectives-file <path>] [--title "..."] [--acceptance-criteria "..."] [--available-tools "..."] [--for-human] [--priority low|medium|high|urgent] [--project-id <id>] [--agent <agent>] [--model <identifier>] [--delegate <agent>]';
   }
 
-  return 'Usage: ovld create --objectives-json \'[{"objective":"..."}]\' [--objectives-file <path>] [--title "..."] [--acceptance-criteria "..."] [--available-tools "..."] [--execution-target agent|human] [--priority low|medium|high|urgent] [--project-id <id>] [--agent <agent>] [--model <identifier>] [--delegate <agent>]';
+  return 'Usage: ovld create --objectives-json \'[{"objective":"..."}]\' [--objectives-file <path>] [--title "..."] [--acceptance-criteria "..."] [--available-tools "..."] [--for-human] [--priority low|medium|high|urgent] [--project-id <id>] [--agent <agent>] [--model <identifier>] [--delegate <agent>]';
+}
+
+function resolveForHumanFlag(flags) {
+  if (flags['for-human'] !== undefined) {
+    const raw = flags['for-human'];
+    if (raw === true) return true;
+    const normalized = String(raw).trim().toLowerCase();
+    return normalized === '' || normalized === 'true' || normalized === '1';
+  }
+
+  if (flags['execution-target'] !== undefined) {
+    return String(flags['execution-target']).trim().toLowerCase() === 'human';
+  }
+
+  return false;
 }
 
 function ensureObjective(commandName, objective) {
@@ -331,7 +346,7 @@ async function runTicketCreationFlow(args, { commandName, launchAgent }) {
     title: String(flags.title ?? ''),
     acceptanceCriteria: String(flags['acceptance-criteria'] ?? ''),
     availableTools: String(flags['available-tools'] ?? ''),
-    executionTarget: String(flags['execution-target'] ?? 'agent'),
+    forHuman: resolveForHumanFlag(flags),
     priority: String(flags.priority ?? 'medium'),
     projectId: selectedProject.id,
     ...(ticketDelegate ? { delegate: ticketDelegate } : {})

package/bin/_cli/protocol.mjs

@@ -267,6 +267,24 @@ function resolveTimeout(flags) {
   return DEFAULT_TIMEOUT_MS;
 }
 
+function resolveForHumanFlag(flags) {
+  if (flags['for-human'] !== undefined) {
+    const raw = flags['for-human'];
+    if (raw === true) return true;
+    if (raw === false) return false;
+    const normalized = String(raw).trim().toLowerCase();
+    if (normalized === '' || normalized === 'true' || normalized === '1') return true;
+    if (normalized === 'false' || normalized === '0') return false;
+    throw new Error('--for-human must be a boolean flag or one of true/false.');
+  }
+
+  if (flags['execution-target'] !== undefined) {
+    return String(flags['execution-target']).trim().toLowerCase() === 'human';
+  }
+
+  return undefined;
+}
+
 function parseRepeatedCliFlags(args, name) {
   const result = [];
   const prefix = `--${name}=`;
@@ -2161,6 +2179,7 @@ async function protocolPrompt(args) {
   const personal = Boolean(flags.personal);
   const workingDirectory =
     flags['working-directory'] ?? (!flags['project-id'] && !personal ? process.cwd() : undefined);
+  const forHuman = resolveForHumanFlag(flags);
 
   const body = {
     ...objectiveInput,
@@ -2176,7 +2195,7 @@ async function protocolPrompt(args) {
       ? { acceptanceCriteria: String(flags['acceptance-criteria']) }
       : {}),
     ...(flags['available-tools'] ? { availableTools: String(flags['available-tools']) } : {}),
-    ...(flags['execution-target'] ? { executionTarget: String(flags['execution-target']) } : {}),
+    ...(forHuman !== undefined ? { forHuman } : {}),
     delegate: resolveProtocolTicketDelegate(flags, modelIdentifier, agentIdentifier),
     ...(flags['parent-session-key']
       ? { parentSessionKey: String(flags['parent-session-key']) }
@@ -2248,6 +2267,7 @@ async function protocolCreateTicket(args) {
   const timeoutMs = resolveTimeout(flags);
   const agentIdentifier = resolveProtocolAgentIdentifier(flags);
   const modelIdentifier = resolveProtocolModelIdentifier(flags);
+  const forHuman = resolveForHumanFlag(flags);
 
   const hasSessionContext = Boolean(sessionKey && ticketId);
 
@@ -2263,7 +2283,7 @@ async function protocolCreateTicket(args) {
         ? { acceptanceCriteria: String(flags['acceptance-criteria']) }
         : {}),
       ...(flags['available-tools'] ? { availableTools: String(flags['available-tools']) } : {}),
-      ...(flags['execution-target'] ? { executionTarget: String(flags['execution-target']) } : {}),
+      ...(forHuman !== undefined ? { forHuman } : {}),
       delegate: resolveProtocolTicketDelegate(flags, modelIdentifier, agentIdentifier)
     };
 
@@ -2303,7 +2323,7 @@ async function protocolCreateTicket(args) {
       ? { acceptanceCriteria: String(flags['acceptance-criteria']) }
       : {}),
     ...(flags['available-tools'] ? { availableTools: String(flags['available-tools']) } : {}),
-    ...(flags['execution-target'] ? { executionTarget: String(flags['execution-target']) } : {}),
+    ...(forHuman !== undefined ? { forHuman } : {}),
     delegate: resolveProtocolTicketDelegate(flags, modelIdentifier, agentIdentifier)
   };
 
@@ -2825,7 +2845,8 @@ prompt:
     --working-directory <path> Override cwd for project resolution (default: cwd)
     --acceptance-criteria <text>
     --available-tools <text>
-    --execution-target <t>    agent | human
+    --for-human               Mark the new ticket as requiring a human
+    --execution-target <t>    Deprecated alias: agent | human
     --delegate <model>        Model or delegate identifier that created the ticket
     --parent-session-key <key>
     --parent-ticket-id <ticket_id>
@@ -2864,7 +2885,8 @@ create:
     --priority <level>        low | medium | high | urgent
     --acceptance-criteria <text>
     --available-tools <text>
-    --execution-target <t>    agent | human
+    --for-human               Mark the new ticket as requiring a human
+    --execution-target <t>    Deprecated alias: agent | human
     --delegate <model>        Model or delegate identifier that created the ticket
     --agent <identifier>
     --model <identifier>

package/bin/_cli/setup.mjs

@@ -47,11 +47,11 @@ function geminiLegacyCommandFiles() {
     },
     {
       path: path.join(base, 'create.toml'),
-      content: `description = "Create a draft Overlord ticket from the current conversation."\nprompt = """\nCreate a draft Overlord ticket from the user's request.\n\nUse \`{{args}}\` as the input.\nIf it already contains flags such as \`--title\`, \`--priority\`, \`--project-id\`, or \`--execution-target\`, pass those flags through after \`ovld protocol create --agent gemini\`.\nOtherwise, treat \`{{args}}\` as the objective text and run:\n\`ovld protocol create --agent gemini --objective "<objective>"\`\n\nIf no objective was provided, ask the user for one and stop.\n\nAfter the command succeeds, report the new \`TICKET_ID\`.\n"""`
+      content: `description = "Create a draft Overlord ticket from the current conversation."\nprompt = """\nCreate a draft Overlord ticket from the user's request.\n\nUse \`{{args}}\` as the input.\nIf it already contains flags such as \`--title\`, \`--priority\`, \`--project-id\`, or \`--for-human\`, pass those flags through after \`ovld protocol create --agent gemini\`.\nOtherwise, treat \`{{args}}\` as the objective text and run:\n\`ovld protocol create --agent gemini --objective "<objective>"\`\n\nIf no objective was provided, ask the user for one and stop.\n\nAfter the command succeeds, report the new \`TICKET_ID\`.\n"""`
     },
     {
       path: path.join(base, 'prompt.toml'),
-      content: `description = "Create a new Overlord ticket from the current conversation."\nprompt = """\nCreate a new Overlord ticket from the user's request.\n\nUse \`{{args}}\` as the input.\nIf it already contains flags such as \`--title\`, \`--priority\`, \`--project-id\`, or \`--execution-target\`, pass those flags through after \`ovld protocol prompt --agent gemini\`.\nOtherwise, treat \`{{args}}\` as the objective text and run:\n\`ovld protocol prompt --agent gemini --objective "<objective>"\`\n\nIf no objective was provided, ask the user for one and stop.\n\nAfter the command succeeds, report the new \`TICKET_ID\` and \`SESSION_KEY\`.\n"""`
+      content: `description = "Create a new Overlord ticket from the current conversation."\nprompt = """\nCreate a new Overlord ticket from the user's request.\n\nUse \`{{args}}\` as the input.\nIf it already contains flags such as \`--title\`, \`--priority\`, \`--project-id\`, or \`--for-human\`, pass those flags through after \`ovld protocol prompt --agent gemini\`.\nOtherwise, treat \`{{args}}\` as the objective text and run:\n\`ovld protocol prompt --agent gemini --objective "<objective>"\`\n\nIf no objective was provided, ask the user for one and stop.\n\nAfter the command succeeds, report the new \`TICKET_ID\` and \`SESSION_KEY\`.\n"""`
     },
     {
       path: path.join(base, 'record-work.toml'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "overlord-cli",
-  "version": "0.2605241431.0",
+  "version": "0.2605241542.0",
   "description": "Overlord CLI — launch AI agents on tickets from anywhere",
   "homepage": "https://www.ovld.ai/docs/",
   "type": "module",

package/plugins/antigravity/commands/create.md

@@ -6,7 +6,7 @@ argument-hint: <objective or raw flags>
 Create a draft Overlord ticket from the user's request.
 
 Use `$ARGUMENTS` as the input.
-If it already contains flags such as `--title`, `--priority`, `--project-id`, or `--execution-target`, pass those flags through after `ovld protocol create --agent antigravity`.
+If it already contains flags such as `--title`, `--priority`, `--project-id`, or `--for-human`, pass those flags through after `ovld protocol create --agent antigravity`.
 Otherwise, treat `$ARGUMENTS` as the objective text and run:
 `ovld protocol create --agent antigravity --objective "<objective>"`
 

package/plugins/antigravity/commands/prompt.md

@@ -6,7 +6,7 @@ argument-hint: <objective or raw flags>
 Create a new Overlord ticket from the user's request and attach immediately.
 
 Use `$ARGUMENTS` as the input.
-If it already contains flags such as `--title`, `--priority`, `--project-id`, or `--execution-target`, pass those flags through after `ovld protocol prompt --agent antigravity`.
+If it already contains flags such as `--title`, `--priority`, `--project-id`, or `--for-human`, pass those flags through after `ovld protocol prompt --agent antigravity`.
 Otherwise, treat `$ARGUMENTS` as the objective text and run:
 `ovld protocol prompt --agent antigravity --objective "<objective>"`
 

package/plugins/antigravity/scripts/overlord-mcp.mjs

@@ -239,7 +239,7 @@ const tools = [
         },
         acceptance_criteria: { type: 'string' },
         available_tools: { type: 'string' },
-        execution_target: { type: 'string', enum: ['agent', 'human'] },
+        for_human: { type: 'boolean' },
         delegate: { type: 'string' },
         parent_session_key: { type: 'string' },
         parent_ticket_id: { type: 'string' },
@@ -257,7 +257,7 @@ const tools = [
       personal: args.personal === true ? true : undefined,
       'acceptance-criteria': args.acceptance_criteria,
       'available-tools': args.available_tools,
-      'execution-target': args.execution_target,
+      'for-human': args.for_human === true ? true : undefined,
       delegate: args.delegate,
       'parent-session-key': args.parent_session_key,
       'parent-ticket-id': args.parent_ticket_id,
@@ -280,7 +280,7 @@ const tools = [
         personal: { type: 'boolean' },
         acceptance_criteria: { type: 'string' },
         available_tools: { type: 'string' },
-        execution_target: { type: 'string', enum: ['agent', 'human'] },
+        for_human: { type: 'boolean' },
         delegate: { type: 'string' },
         session_key: { type: 'string' },
         ticket_id: { type: 'string' },
@@ -297,7 +297,7 @@ const tools = [
       personal: args.personal === true ? true : undefined,
       'acceptance-criteria': args.acceptance_criteria,
       'available-tools': args.available_tools,
-      'execution-target': args.execution_target,
+      'for-human': args.for_human === true ? true : undefined,
       delegate: args.delegate,
       'session-key': args.session_key,
       'ticket-id': args.ticket_id,

package/plugins/antigravity/skills/overlord-ticket/SKILL.md

@@ -217,9 +217,9 @@ ovld protocol get-device --device-fingerprint "$OVERLORD_DEVICE_FINGERPRINT"
 ovld protocol list-project-resources --project-id <project_uuid> --device-fingerprint "$OVERLORD_DEVICE_FINGERPRINT"
 ```
 
-### Choosing `--execution-target`
+### Choosing `--for-human`
 
-Pass `--execution-target agent` or `--execution-target human` (default: `human`) when creating tickets.
+Pass `--for-human agent` or `--for-human human` (default: `human`) when creating tickets.
 
 - **`agent`** — any task an AI agent can complete in a computer environment: coding, internet research, document editing, data analysis, automated testing, etc.
 - **`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.

package/plugins/claude/commands/create.md

@@ -8,7 +8,7 @@ Create a draft Overlord ticket from the user's request.
 
 
 Use `$ARGUMENTS` as the input.
-If it already contains flags such as `--title`, `--priority`, `--project-id`, or `--execution-target`, pass those flags through after `ovld protocol create --agent claude-code`.
+If it already contains flags such as `--title`, `--priority`, `--project-id`, or `--for-human`, pass those flags through after `ovld protocol create --agent claude-code`.
 Otherwise, treat `$ARGUMENTS` as the objective text and run:
 `ovld protocol create --agent claude-code --objective "<objective>"`
 

package/plugins/claude/commands/prompt.md

@@ -8,7 +8,7 @@ Create a new Overlord ticket from the user's request.
 
 
 Use `$ARGUMENTS` as the input.
-If it already contains flags such as `--title`, `--priority`, `--project-id`, or `--execution-target`, pass those flags through after `ovld protocol prompt --agent claude-code`.
+If it already contains flags such as `--title`, `--priority`, `--project-id`, or `--for-human`, pass those flags through after `ovld protocol prompt --agent claude-code`.
 Otherwise, treat `$ARGUMENTS` as the objective text and run:
 `ovld protocol prompt --agent claude-code --objective "<objective>"`
 

package/plugins/claude/commands/spawn.md

@@ -9,7 +9,7 @@ This command is deprecated. Use `/overlord:prompt` instead.
 Create a new Overlord ticket from the user's request.
 
 Use `$ARGUMENTS` as the input.
-If it already contains flags such as `--title`, `--priority`, `--project-id`, or `--execution-target`, pass those flags through after `ovld protocol prompt --agent claude-code`.
+If it already contains flags such as `--title`, `--priority`, `--project-id`, or `--for-human`, pass those flags through after `ovld protocol prompt --agent claude-code`.
 Otherwise, treat `$ARGUMENTS` as the objective text and run:
 `ovld protocol prompt --agent claude-code --objective "<objective>"`
 

package/plugins/claude/skills/overlord-ticket/SKILL.md

@@ -109,7 +109,7 @@ For the `record-change-rationales` command and full payload shape with optional
 
 - [reference/cli.md](reference/cli.md) — Full protocol command syntax, flags, phases, ticket creation, and project discovery
 - [reference/mcp.md](reference/mcp.md) — MCP tool naming, key casing, hosted vs local shim defaults
-- [reference/devices.md](reference/devices.md) — Device fingerprints, project resources, and `--execution-target`
+- [reference/devices.md](reference/devices.md) — Device fingerprints, project resources, and `--for-human`
 - [reference/context.md](reference/context.md) — Shared state, attachments, and large artifact policy
 - [reference/shell-escaping.md](reference/shell-escaping.md) — Heredoc stdin piping for special characters in summaries and payloads
 

package/plugins/claude/skills/overlord-ticket/reference/devices.md

@@ -9,9 +9,9 @@ ovld protocol list-project-resources --project-id <project_uuid> --device-finger
 
 `ovld runner start` uses the same execution target identity and project resource directories to claim queued execution requests from manual Run and auto-advance. Primary resource directories are scoped per `(project, execution target)`. `ovld runner once` claims at most one request and exits.
 
-## Choosing `--execution-target`
+## Choosing `--for-human`
 
-Pass `--execution-target agent` or `--execution-target human` (default: `human`) when creating tickets.
+Pass `--for-human agent` or `--for-human human` (default: `human`) when creating tickets.
 
 - **`agent`** — any task an AI agent can complete in a computer environment: coding, internet research, document editing, data analysis, automated testing, etc.
 - **`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.

package/plugins/cursor/skills/overlord-ticket/SKILL.md

@@ -109,7 +109,7 @@ For the `record-change-rationales` command and full payload shape with optional
 
 - [reference/cli.md](reference/cli.md) — Full protocol command syntax, flags, phases, ticket creation, and project discovery
 - [reference/mcp.md](reference/mcp.md) — MCP tool naming, key casing, hosted vs local shim defaults
-- [reference/devices.md](reference/devices.md) — Device fingerprints, project resources, and `--execution-target`
+- [reference/devices.md](reference/devices.md) — Device fingerprints, project resources, and `--for-human`
 - [reference/context.md](reference/context.md) — Shared state, attachments, and large artifact policy
 - [reference/shell-escaping.md](reference/shell-escaping.md) — Heredoc stdin piping for special characters in summaries and payloads
 

package/plugins/cursor/skills/overlord-ticket/reference/devices.md

@@ -9,9 +9,9 @@ ovld protocol list-project-resources --project-id <project_uuid> --device-finger
 
 `ovld runner start` uses the same execution target identity and project resource directories to claim queued execution requests from manual Run and auto-advance. Primary resource directories are scoped per `(project, execution target)`. `ovld runner once` claims at most one request and exits.
 
-## Choosing `--execution-target`
+## Choosing `--for-human`
 
-Pass `--execution-target agent` or `--execution-target human` (default: `human`) when creating tickets.
+Pass `--for-human agent` or `--for-human human` (default: `human`) when creating tickets.
 
 - **`agent`** — any task an AI agent can complete in a computer environment: coding, internet research, document editing, data analysis, automated testing, etc.
 - **`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.

package/plugins/overlord/scripts/overlord-mcp.mjs

@@ -239,7 +239,7 @@ const tools = [
         },
         acceptance_criteria: { type: 'string' },
         available_tools: { type: 'string' },
-        execution_target: { type: 'string', enum: ['agent', 'human'] },
+        for_human: { type: 'boolean' },
         delegate: { type: 'string' },
         parent_session_key: { type: 'string' },
         parent_ticket_id: { type: 'string' },
@@ -257,7 +257,7 @@ const tools = [
       personal: args.personal === true ? true : undefined,
       'acceptance-criteria': args.acceptance_criteria,
       'available-tools': args.available_tools,
-      'execution-target': args.execution_target,
+      'for-human': args.for_human === true ? true : undefined,
       delegate: args.delegate,
       'parent-session-key': args.parent_session_key,
       'parent-ticket-id': args.parent_ticket_id,
@@ -280,7 +280,7 @@ const tools = [
         personal: { type: 'boolean' },
         acceptance_criteria: { type: 'string' },
         available_tools: { type: 'string' },
-        execution_target: { type: 'string', enum: ['agent', 'human'] },
+        for_human: { type: 'boolean' },
         delegate: { type: 'string' },
         session_key: { type: 'string' },
         ticket_id: { type: 'string' },
@@ -297,7 +297,7 @@ const tools = [
       personal: args.personal === true ? true : undefined,
       'acceptance-criteria': args.acceptance_criteria,
       'available-tools': args.available_tools,
-      'execution-target': args.execution_target,
+      'for-human': args.for_human === true ? true : undefined,
       delegate: args.delegate,
       'session-key': args.session_key,
       'ticket-id': args.ticket_id,

package/plugins/overlord/skills/overlord-ticket/SKILL.md

@@ -110,7 +110,7 @@ For the `record-change-rationales` command and full payload shape with optional
 
 - [reference/cli.md](reference/cli.md) — Full protocol command syntax, flags, phases, ticket creation, and project discovery
 - [reference/mcp.md](reference/mcp.md) — MCP tool naming, key casing, hosted vs local shim defaults
-- [reference/devices.md](reference/devices.md) — Device fingerprints, project resources, and `--execution-target`
+- [reference/devices.md](reference/devices.md) — Device fingerprints, project resources, and `--for-human`
 - [reference/context.md](reference/context.md) — Shared state, attachments, and large artifact policy
 - [reference/shell-escaping.md](reference/shell-escaping.md) — Heredoc stdin piping for special characters in summaries and payloads
 

package/plugins/overlord/skills/overlord-ticket/reference/devices.md

@@ -9,9 +9,9 @@ ovld protocol list-project-resources --project-id <project_uuid> --device-finger
 
 `ovld runner start` uses the same execution target identity and project resource directories to claim queued execution requests from manual Run and auto-advance. Primary resource directories are scoped per `(project, execution target)`. `ovld runner once` claims at most one request and exits.
 
-## Choosing `--execution-target`
+## Choosing `--for-human`
 
-Pass `--execution-target agent` or `--execution-target human` (default: `human`) when creating tickets.
+Pass `--for-human agent` or `--for-human human` (default: `human`) when creating tickets.
 
 - **`agent`** — any task an AI agent can complete in a computer environment: coding, internet research, document editing, data analysis, automated testing, etc.
 - **`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.