agent-conveyor 0.1.5 → 0.1.7

package/dist/cli/typescript-runtime.js

@@ -76,7 +76,7 @@ export function runTypescriptRuntimeCommand(options) {
         return errorResult(`unknown command: ${parsed.command}`);
     }
     if (parsed.flags.help) {
-        return textResult([`usage: ${program} ${parsed.command} [-h] [options]`]);
+        return textResult(commandHelpText(program, parsed.command));
     }
     if (parsed.error) {
         return errorResult(parsed.error);
@@ -337,6 +337,70 @@ export function runTypescriptRuntimeCommand(options) {
         return errorResult(error instanceof Error ? error.message : String(error));
     }
 }
+function commandHelpText(program, command) {
+    const path = "[--path <workerctl.db>]";
+    const linesByCommand = {
+        criteria: [
+            `usage: ${program} criteria <task> [--list|--add --criterion <text> --source <source>|--accept ID|--satisfy ID|--defer ID|--reject ID] ${path} [--json]`,
+            "",
+            "Examples:",
+            `  ${program} criteria my-task --list --json --path /tmp/work/workerctl.db`,
+            `  ${program} criteria my-task --add --criterion "Note file exists" --source manager_inferred --status accepted --path /tmp/work/workerctl.db`,
+            `  ${program} criteria my-task --satisfy 1 --proof "File exists" --evidence-json '{"artifact":{"path":"docs/note.md"}}' --path /tmp/work/workerctl.db`,
+        ],
+        "finish-task": [
+            `usage: ${program} finish-task <task> --reason <reason> [--require-criteria-audit] ${path}`,
+            "",
+            "Examples:",
+            `  ${program} finish-task my-task --reason "Accepted criteria satisfied" --require-criteria-audit --path /tmp/work/workerctl.db`,
+        ],
+        "manager-ack": [
+            `usage: ${program} manager-ack <task> --from-stdin ${path}`,
+            `usage: ${program} manager-ack <task> --json ${path}`,
+            "",
+            "Example JSON:",
+            `  {"task":"my-task","manager_session":"mgr","supervision_contract":"I will supervise through Conveyor and verify criteria before finishing.","will_not_edit_project_files":true}`,
+        ],
+        nudge: [
+            `usage: ${program} nudge <worker-or-session> <message> ${path} [--dry-run]`,
+            `usage: ${program} session-nudge <session> <message> ${path} [--dry-run]`,
+            "",
+            "For task-routed delivery, prefer enqueue-nudge-worker plus dispatch:",
+            `  ${program} enqueue-nudge-worker my-task --message "Status and evidence?" --path /tmp/work/workerctl.db`,
+            `  ${program} dispatch --once --type nudge_worker --path /tmp/work/workerctl.db`,
+        ],
+        pair: [
+            `usage: ${program} pair --task <task> --worker-name <worker> --manager-name <manager> [options] ${path}`,
+            "",
+            "Options:",
+            "  --task-goal <text>             Task goal stored in Conveyor state.",
+            "  --task-prompt <text>           Initial worker prompt; defaults to task goal when omitted.",
+            "  --manager-recipe <recipe>      Seed a manager recipe, for example goalbuddy-conveyor.",
+            "  --manager-acceptance <text>    Seed an accepted manager criterion; repeat for multiple criteria.",
+            "  --manager-tool <tool>          Seed an expected manager/worker tool; repeat for multiple tools.",
+            "  --manager-reference <path>     Seed a manager reference path; repeat for multiple references.",
+            "  --manager-question <text>      Seed a manager setup question; repeat for multiple questions.",
+            "  --manager-guideline <text>     Seed a manager guideline; repeat for multiple guidelines.",
+            "  --cwd <dir>                    Working directory for both Codex sessions.",
+            "  --accept-trust                 Auto-accept the Codex trust prompt for the chosen cwd.",
+            "  --no-dispatch                  Do not start Dispatch after launching the pair.",
+            "  --dry-run                      Print the launch plan without creating sessions.",
+            "  --json                         Emit JSON output.",
+            "",
+            "Examples:",
+            `  ${program} pair --task dogfood --worker-name dogfood-worker --manager-name dogfood-manager --task-goal "Create docs/note.md" --task-prompt "Create docs/note.md" --manager-recipe goalbuddy-conveyor --manager-acceptance "docs/note.md exists" --cwd /tmp/work --path /tmp/work/workerctl.db --accept-trust`,
+            `  ${program} pair --task dogfood --worker-name dogfood-worker --manager-name dogfood-manager --path /tmp/work/workerctl.db --dry-run --json`,
+        ],
+        "worker-ack": [
+            `usage: ${program} worker-ack <task> --from-stdin ${path}`,
+            `usage: ${program} worker-ack <task> --json ${path}`,
+            "",
+            "Example JSON:",
+            `  {"goal_restatement":"Create docs/dogfood-note.md","proposed_criteria":{"must_have":["note file exists"],"follow_up":[]},"expected_tools":["shell"],"open_questions":[],"ready_to_start":true}`,
+        ],
+    };
+    return linesByCommand[command] ?? [`usage: ${program} ${command} [-h] [options]`];
+}
 function parseRuntimeArgs(args, env) {
     const flags = {
         format: "timeline",
@@ -502,6 +566,7 @@ function parseRuntimeArgs(args, env) {
         managerObjective: null,
         managerPermissionsJson: null,
         managerPermit: [],
+        managerRecipe: null,
         managerReference: [],
         managerRequireAcks: false,
         managerTool: [],
@@ -1421,6 +1486,17 @@ function parseRuntimeArgs(args, env) {
             flags.managerMode = value.value;
             index += 1;
         }
+        else if (arg === "--manager-recipe") {
+            if (command !== "pair") {
+                return { command, enabled, error: "Unsupported TypeScript runtime option: --manager-recipe", explicit, flags, task };
+            }
+            const value = valueAfter(queue, index, arg);
+            if (value.error) {
+                return { command, enabled, error: value.error, explicit, flags, task };
+            }
+            flags.managerRecipe = value.value;
+            index += 1;
+        }
         else if (arg === "--manager-objective") {
             if (command !== "pair") {
                 return { command, enabled, error: "Unsupported TypeScript runtime option: --manager-objective", explicit, flags, task };
@@ -1555,6 +1631,17 @@ function parseRuntimeArgs(args, env) {
             flags.managerObjective = value.value;
             index += 1;
         }
+        else if (arg === "--recipe") {
+            if (command !== "manager-config") {
+                return { command, enabled, error: "Unsupported TypeScript runtime option: --recipe", explicit, flags, task };
+            }
+            const value = valueAfter(queue, index, arg);
+            if (value.error) {
+                return { command, enabled, error: value.error, explicit, flags, task };
+            }
+            flags.managerRecipe = value.value;
+            index += 1;
+        }
         else if (arg === "--guideline") {
             if (command !== "manager-config") {
                 return { command, enabled, error: "Unsupported TypeScript runtime option: --guideline", explicit, flags, task };
@@ -5371,6 +5458,7 @@ function runStartSessionCommand(parsed, options, role) {
         const initialPrompt = role === "manager"
             ? startManagerBootstrapPrompt(database, {
                 cwd,
+                dbPath: runtimeDbPath(parsed, options),
                 managerName: name,
                 taskGoal: parsed.flags.taskGoal,
                 taskName: parsed.flags.taskName,
@@ -5697,7 +5785,7 @@ function runPairCommand(parsed, options) {
         return unsupportedRuntimeResult(parsed, "pair requires --task, --worker-name, and --manager-name.");
     }
     const dbPath = runtimeDbPath(parsed, options);
-    const dispatch = pairDispatchPayload(parsed, dbPath);
+    const dispatch = pairDispatchPayload(parsed, dbPath, options);
     const packageRoot = packageRootFromRuntimeModule();
     if (parsed.flags.dryRun) {
         return jsonResult({
@@ -5708,6 +5796,18 @@ function runPairCommand(parsed, options) {
             worker: workerName,
         });
     }
+    const codexPreflight = ensureRequiredTool("codex", options);
+    if (codexPreflight) {
+        return codexPreflight;
+    }
+    const tmuxPreflight = ensureTmuxAvailable(options.tmuxRunner ?? defaultTmuxRunner);
+    if (tmuxPreflight) {
+        return tmuxPreflight;
+    }
+    const tmuxAccessPreflight = ensureTmuxServerAccessible(options.tmuxRunner ?? defaultTmuxRunner);
+    if (tmuxAccessPreflight) {
+        return tmuxAccessPreflight;
+    }
     const cwd = parsed.flags.cwd ?? options.cwd ?? process.cwd();
     const database = openRuntimeDatabase(parsed, options);
     let taskId = null;
@@ -5774,6 +5874,7 @@ function runPairCommand(parsed, options) {
             managerObjective: parsed.flags.managerObjective,
             managerPermissionsJson: parsed.flags.managerPermissionsJson,
             managerPermit: parsed.flags.managerPermit,
+            managerRecipe: parsed.flags.managerRecipe,
             managerReference: parsed.flags.managerReference,
             managerRequireAcks: parsed.flags.managerRequireAcks,
             managerTool: parsed.flags.managerTool,
@@ -5824,7 +5925,7 @@ function runPairCommand(parsed, options) {
             acceptTrust: parsed.flags.acceptTrust,
             askForApproval: startup.askForApproval,
             cwd,
-            initialPrompt: workerAckTaskPrompt(taskName, parsed.flags.taskPrompt),
+            initialPrompt: workerAckTaskPrompt(taskName, parsed.flags.taskPrompt, dbPath),
             name: workerName,
             role: "worker",
             sandbox: startup.sandbox,
@@ -5852,6 +5953,7 @@ function runPairCommand(parsed, options) {
             cwd,
             initialPrompt: startManagerBootstrapPrompt(database, {
                 cwd,
+                dbPath,
                 managerName,
                 taskGoal: task.goal,
                 taskName,
@@ -6011,14 +6113,13 @@ function taskRowForPair(database, taskName) {
   `).get(taskName, taskName);
     return row ?? null;
 }
-function pairDispatchPayload(parsed, dbPath) {
+function pairDispatchPayload(parsed, dbPath, options) {
     const dispatcherId = parsed.flags.dispatcherId;
     const ensureDispatch = dispatcherId !== null && !parsed.flags.noDispatch;
-    const packageRoot = packageRootFromRuntimeModule();
     return {
         dispatchCommand: ensureDispatch
             ? [
-                join(packageRoot, "scripts", "workerctl"),
+                workerctlDispatchExecutable(options),
                 "dispatch",
                 "--watch",
                 "--dispatcher-id",
@@ -6030,6 +6131,17 @@ function pairDispatchPayload(parsed, dbPath) {
         ensureDispatch,
     };
 }
+function workerctlDispatchExecutable(options) {
+    const workerctlPath = commandPath("workerctl", options);
+    if (workerctlPath) {
+        return workerctlPath;
+    }
+    const workerctlScript = join(packageRootFromRuntimeModule(), "scripts", "workerctl");
+    if (pathIsExecutable(workerctlScript)) {
+        return workerctlScript;
+    }
+    throw new Error(`Cannot start Dispatch: workerctl is not on PATH and ${workerctlScript} is not executable.`);
+}
 function emitPairTelemetry(database, options) {
     emitTelemetrySync(database, {
         actor: "workerctl",
@@ -6053,6 +6165,7 @@ function emitPairTelemetry(database, options) {
 function ensurePairManagerConfig(database, options) {
     const existing = managerConfigSync(database, options.taskId);
     const requested = options.managerMode !== null
+        || options.managerRecipe !== null
         || options.managerObjective !== null
         || options.managerGuideline.length > 0
         || options.managerAcceptance.length > 0
@@ -6073,6 +6186,7 @@ function ensurePairManagerConfig(database, options) {
     if (supervisionMode !== "light" && supervisionMode !== "guided" && supervisionMode !== "strict") {
         throw new Error("manager_mode must be light, guided, or strict");
     }
+    const recipeName = cleanManagerRecipeName(options.managerRecipe, existing?.recipe_name ?? (existing === null ? "custom" : null));
     const objective = options.managerObjective !== null ? options.managerObjective : existing?.objective ?? null;
     const guidelines = options.managerGuideline.length > 0 ? options.managerGuideline : existing?.guidelines ?? [];
     const acceptanceCriteria = options.managerAcceptance.length > 0
@@ -6093,13 +6207,14 @@ function ensurePairManagerConfig(database, options) {
     const requireAcks = options.managerRequireAcks || (existing?.require_acks ?? false);
     database.prepare(`
     insert into manager_configs(
-      task_id, supervision_mode, objective, guidelines_json,
+      task_id, recipe_name, supervision_mode, objective, guidelines_json,
       acceptance_criteria_json, reference_paths_json, permissions_json,
       tools_json, epilogues_json, nudge_on_completion, require_acks,
       revision, created_at, updated_at
     )
-    values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?)
+    values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?)
     on conflict(task_id) do update set
+      recipe_name = excluded.recipe_name,
       supervision_mode = excluded.supervision_mode,
       objective = excluded.objective,
       guidelines_json = excluded.guidelines_json,
@@ -6111,6 +6226,7 @@ function ensurePairManagerConfig(database, options) {
       nudge_on_completion = excluded.nudge_on_completion,
       require_acks = excluded.require_acks,
       revision = case when
+        manager_configs.recipe_name is not excluded.recipe_name or
         manager_configs.supervision_mode is not excluded.supervision_mode or
         manager_configs.objective is not excluded.objective or
         manager_configs.guidelines_json is not excluded.guidelines_json or
@@ -6123,7 +6239,7 @@ function ensurePairManagerConfig(database, options) {
         manager_configs.require_acks is not excluded.require_acks
       then manager_configs.revision + 1 else manager_configs.revision end,
       updated_at = excluded.updated_at
-  `).run(options.taskId, supervisionMode, objective, stableJson(guidelines), stableJson(acceptanceCriteria), stableJson(referencePaths), stableJson(permissions), stableJson(tools), stableJson(epilogues), nudgeOnCompletion, requireAcks ? 1 : 0, options.timestamp, options.timestamp);
+  `).run(options.taskId, recipeName, supervisionMode, objective, stableJson(guidelines), stableJson(acceptanceCriteria), stableJson(referencePaths), stableJson(permissions), stableJson(tools), stableJson(epilogues), nudgeOnCompletion, requireAcks ? 1 : 0, options.timestamp, options.timestamp);
     const config = managerConfigSync(database, options.taskId);
     if (config === null) {
         throw new Error(`manager config was not recorded for task ${options.taskId}`);
@@ -6379,20 +6495,24 @@ function spawnCodexAndRegisterPairSession(database, parsed, options, params) {
         tmux_session: registered.tmux_session,
     };
 }
-function workerAckTaskPrompt(taskName, taskPrompt) {
+function workerAckTaskPrompt(taskName, taskPrompt, dbPath) {
     if (taskPrompt === null) {
         return null;
     }
     const taskRef = taskName ?? "<task>";
+    const pathSuffix = commandPathSuffix(dbPath);
     return [
         taskPrompt,
         "",
         "Before editing files or running implementation work, acknowledge the task contract:",
         "",
-        `conveyor worker-ack ${taskRef} --from-stdin`,
+        `conveyor worker-ack ${taskRef} --from-stdin${pathSuffix}`,
+        "",
+        "Use a JSON object like:",
+        "",
+        `{"goal_restatement":"Restate the assigned task.","proposed_criteria":{"must_have":["Current-task proof"],"follow_up":[]},"expected_tools":["shell"],"open_questions":[],"ready_to_start":true}`,
         "",
-        "Use a JSON object with goal_restatement, proposed_criteria, expected_tools,",
-        "open_questions, and ready_to_start.",
+        "When your implementation is complete, leave a concise final reply with the files changed and verification you ran. Do not call `conveyor finish-task`; the manager owns criteria satisfaction and audited task closeout.",
     ].join("\n");
 }
 function createPairRunSync(database, options) {
@@ -11842,6 +11962,7 @@ function insertCompatEventSync(database, options) {
 }
 function managerConfigMutationRequested(parsed) {
     return parsed.flags.managerMode !== null
+        || parsed.flags.managerRecipe !== null
         || parsed.flags.managerObjective !== null
         || parsed.flags.managerGuideline.length > 0
         || parsed.flags.managerAcceptance.length > 0
@@ -11860,6 +11981,7 @@ function upsertManagerConfigFromParsed(database, options) {
     const parsed = options.parsed;
     const existing = options.existing;
     const supervisionMode = parsed.flags.managerMode ?? existing?.supervision_mode ?? "guided";
+    const recipeName = cleanManagerRecipeName(parsed.flags.managerRecipe, existing?.recipe_name ?? null);
     const objective = parsed.flags.managerObjective !== null ? parsed.flags.managerObjective : existing?.objective ?? null;
     const guidelines = parsed.flags.managerGuideline.length > 0 ? parsed.flags.managerGuideline : existing?.guidelines ?? [];
     const acceptanceCriteria = parsed.flags.managerAcceptance.length > 0
@@ -11880,13 +12002,14 @@ function upsertManagerConfigFromParsed(database, options) {
     const requireAcks = parsed.flags.managerRequireAcks || (existing?.require_acks ?? false);
     database.prepare(`
     insert into manager_configs(
-      task_id, supervision_mode, objective, guidelines_json,
+      task_id, recipe_name, supervision_mode, objective, guidelines_json,
       acceptance_criteria_json, reference_paths_json, permissions_json,
       tools_json, epilogues_json, nudge_on_completion, require_acks,
       revision, created_at, updated_at
     )
-    values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?)
+    values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?)
     on conflict(task_id) do update set
+      recipe_name = excluded.recipe_name,
       supervision_mode = excluded.supervision_mode,
       objective = excluded.objective,
       guidelines_json = excluded.guidelines_json,
@@ -11898,6 +12021,7 @@ function upsertManagerConfigFromParsed(database, options) {
       nudge_on_completion = excluded.nudge_on_completion,
       require_acks = excluded.require_acks,
       revision = case when
+        manager_configs.recipe_name is not excluded.recipe_name or
         manager_configs.supervision_mode is not excluded.supervision_mode or
         manager_configs.objective is not excluded.objective or
         manager_configs.guidelines_json is not excluded.guidelines_json or
@@ -11910,7 +12034,7 @@ function upsertManagerConfigFromParsed(database, options) {
         manager_configs.require_acks is not excluded.require_acks
       then manager_configs.revision + 1 else manager_configs.revision end,
       updated_at = excluded.updated_at
-  `).run(options.taskId, supervisionMode, objective, stableJson(guidelines), stableJson(acceptanceCriteria), stableJson(referencePaths), stableJson(permissions), stableJson(tools), stableJson(epilogues), nudgeOnCompletion, requireAcks ? 1 : 0, options.timestamp, options.timestamp);
+  `).run(options.taskId, recipeName, supervisionMode, objective, stableJson(guidelines), stableJson(acceptanceCriteria), stableJson(referencePaths), stableJson(permissions), stableJson(tools), stableJson(epilogues), nudgeOnCompletion, requireAcks ? 1 : 0, options.timestamp, options.timestamp);
     const config = managerConfigSync(database, options.taskId);
     if (config === null) {
         throw new Error(`manager config was not recorded for task ${options.taskId}`);
@@ -11933,6 +12057,16 @@ function cleanManagerNudgeOnCompletion(value) {
     }
     return value;
 }
+function cleanManagerRecipeName(value, existing) {
+    if (value === null) {
+        return existing;
+    }
+    const normalized = normalizeManagerRecipeName(value);
+    if (normalized === "custom") {
+        return null;
+    }
+    return managerRecipeDefinition(normalized).name;
+}
 function managerPermissionWarnings(permissions) {
     const warnings = [];
     for (const [key, value] of Object.entries(permissions ?? {})) {
@@ -16618,16 +16752,20 @@ function startManagerBootstrapPrompt(database, options) {
     const goalLine = options.taskGoal ?? context?.goal ?? "No task goal supplied yet.";
     const workerLine = options.workerName ?? "No worker session supplied yet.";
     const workerctl = "conveyor";
+    const pathSuffix = commandPathSuffix(options.dbPath);
     const setupCommand = options.taskName
-        ? `${workerctl} manager-config ${taskLine} --questions`
-        : `${workerctl} manager-config <task> --questions`;
-    const cycleCommand = options.taskName ? `${workerctl} cycle ${taskLine}` : `${workerctl} cycle <task>`;
+        ? `${workerctl} manager-config ${taskLine} --questions${pathSuffix}`
+        : `${workerctl} manager-config <task> --questions${pathSuffix}`;
+    const cycleCommand = options.taskName ? `${workerctl} cycle ${taskLine}${pathSuffix}` : `${workerctl} cycle <task>${pathSuffix}`;
     const managerAckCommand = options.taskName
-        ? `${workerctl} manager-ack ${taskLine} --from-stdin`
-        : `${workerctl} manager-ack <task> --from-stdin`;
+        ? `${workerctl} manager-ack ${taskLine} --from-stdin${pathSuffix}`
+        : `${workerctl} manager-ack <task> --from-stdin${pathSuffix}`;
     const workerAckCommand = options.taskName
-        ? `${workerctl} worker-ack ${taskLine} --json`
-        : `${workerctl} worker-ack <task> --json`;
+        ? `${workerctl} worker-ack ${taskLine} --json${pathSuffix}`
+        : `${workerctl} worker-ack <task> --json${pathSuffix}`;
+    const satisfyCriterionCommand = options.taskName
+        ? `${workerctl} criteria ${taskLine} --satisfy <id> --proof "<proof>" --evidence-json '{"status":"pass","command":"<command>","summary":"<what this proved>"}'${pathSuffix}`
+        : `${workerctl} criteria <task> --satisfy <id> --proof "<proof>" --evidence-json '{"status":"pass","command":"<command>","summary":"<what this proved>"}'${pathSuffix}`;
     const config = context ? managerConfigSync(database, context.id) : null;
     const initialSetup = config
         ? seededManagerConfigSetup({ config, cycleCommand, managerAckCommand, workerAckCommand })
@@ -16635,11 +16773,12 @@ function startManagerBootstrapPrompt(database, options) {
             "Initial setup:",
             `1. Run \`${setupCommand}\`.`,
             "2. Ask the user the returned setup questions in this manager Codex chat.",
-            `3. Persist the answers with \`${workerctl} manager-config\`.`,
+            `3. Persist the answers with \`${workerctl} manager-config${pathSuffix}\`.`,
             "4. Use `conveyor manager-config --interactive` only when a human is directly running conveyor in a terminal.",
             "",
             "Acknowledgement:",
             `- Before your first cycle, record the supervision contract you are committing to with \`${managerAckCommand}\`.`,
+            `  Example JSON: {"task":"${taskLine}","manager_session":"${options.managerName}","supervision_contract":"I will supervise through Conveyor and verify criteria before finishing.","will_not_edit_project_files":true}`,
             `- Before nudging or finishing, inspect the worker acknowledgement with \`${workerAckCommand}\` when available.`,
         ].join("\n");
     return [
@@ -16662,7 +16801,8 @@ function startManagerBootstrapPrompt(database, options) {
         "- Inspect `manager_context.acceptance_criteria` each cycle.",
         "- If worker progress reveals new edge cases, tests, polish, or scope boundaries, ask the worker to propose must-have vs follow-up criteria.",
         "- Before finishing, compare worker receipts/verification against accepted open criteria.",
-        `- When all accepted criteria are satisfied, deferred, or rejected, finish the task with \`${workerctl} finish-task ${taskLine} --reason "Accepted criteria satisfied" --require-criteria-audit\`.`,
+        `- For each accepted criterion that is proven, record evidence with \`${satisfyCriterionCommand}\`.`,
+        `- When all accepted criteria are satisfied, deferred, or rejected, finish the task with \`${workerctl} finish-task ${taskLine} --reason "Accepted criteria satisfied" --require-criteria-audit${pathSuffix}\`.`,
         "- Communicate with the worker only through conveyor session/task commands.",
         "- Do not edit project files unless the user explicitly asks this manager session to change Agent Conveyor itself.",
     ].join("\n");
@@ -16677,7 +16817,7 @@ function seededManagerConfigSetup(options) {
     if (options.config.tools.length > 0) {
         lines.push(`Expected tools: ${options.config.tools.join(", ")}.`);
     }
-    lines.push("", "Acknowledgement:", `- Before your first cycle, record the supervision contract you are committing to with \`${options.managerAckCommand}\`.`, `- Before nudging or finishing, inspect the worker acknowledgement with \`${options.workerAckCommand}\` when available.`);
+    lines.push("", "Acknowledgement:", `- Before your first cycle, record the supervision contract you are committing to with \`${options.managerAckCommand}\`.`, `  Example JSON: {"task":"${options.config.task_id}","supervision_contract":"I will supervise through Conveyor and verify criteria before finishing.","will_not_edit_project_files":true}`, `- Before nudging or finishing, inspect the worker acknowledgement with \`${options.workerAckCommand}\` when available.`);
     return lines.join("\n");
 }
 function startManagerTaskContext(database, taskName) {
@@ -16691,6 +16831,9 @@ function startManagerTaskContext(database, taskName) {
 function shellQuote(value) {
     return `'${value.replace(/'/g, "'\"'\"'")}'`;
 }
+function commandPathSuffix(dbPath) {
+    return dbPath ? ` --path ${shellQuote(dbPath)}` : "";
+}
 function emitTelemetrySync(database, options) {
     const eventId = `telemetry-${randomUUID()}`;
     const attributesJson = stableJson(options.attributes);
@@ -18149,9 +18292,8 @@ The supported manager/worker setup is session-based:
 
    ${workerctl} worker-ack <task-name> --from-stdin
 
-   The JSON should include goal_restatement, proposed_criteria,
-   expected_tools, open_questions, and ready_to_start. Proposed criteria should
-   separate must-have and follow-up criteria.
+   Example JSON:
+   {"goal_restatement":"Restate the assigned task.","proposed_criteria":{"must_have":["Current-task proof"],"follow_up":[]},"expected_tools":["shell"],"open_questions":[],"ready_to_start":true}
 
 Required fields:
 - worker name
@@ -18238,6 +18380,14 @@ function ensureTmuxAvailable(runner) {
     const detail = (result.stderr || result.stdout || `exit code ${result.status}`).trim();
     return lifecycleWorkerErrorResult(tmuxCommandFailureMessage(["tmux", "-V"], detail));
 }
+function ensureTmuxServerAccessible(runner) {
+    const result = runner(["tmux", "start-server"], { check: false });
+    if (result.status === 0) {
+        return null;
+    }
+    const detail = (result.stderr || result.stdout || `exit code ${result.status}`).trim();
+    return lifecycleWorkerErrorResult(tmuxCommandFailureMessage(["tmux", "start-server"], detail));
+}
 const CONTENT_KEYS = new Set(["content", "message", "output", "segment_text", "text"]);
 function redactPayload(value) {
     if (Array.isArray(value)) {