dev-manager Cockpit

{
  "key": "awaiting_clarification",
  "summary": "Answer or escalate a worker question with the smallest safe step.",
  "audience": "responder",
  "trigger_states": ["awaiting_clarification"],
  "allowed_actions": ["answer", "escalate"],
  "message_template": "This session is waiting on clarification. Answer the question directly from the repository docs and current codebase. If the docs do not cover it, say exactly what is missing and the smallest next step. Question: {{.Reason}}.",
  "operator_note_template": "Clarification playbook selected for {{.SessionID}}.",
  "stop_conditions": ["question answered", "escalated to human review"],
  "evidence": ["clarification question present", "confidence available"]
}

{
  "key": "blocked_merge",
  "summary": "Clear merge conflicts or report the exact blocker.",
  "audience": "reviewer",
  "trigger_states": ["blocked"],
  "allowed_actions": ["nudge", "escalate"],
  "message_template": "This session is blocked by merge or review state. Resolve the blocker directly now. If this is a merge conflict or behind-base PR, update from the base branch, resolve conflicts, rerun the relevant tests, and push an updated PR. If you still cannot proceed, report the exact blocker and the smallest next step.",
  "operator_note_template": "Merge-block playbook selected for {{.ItemLabel}} because {{.Reason}}.",
  "stop_conditions": ["blocker resolved", "human review required"],
  "evidence": ["merge conflict", "branch protection", "base branch drift", "changes requested"]
}

{
  "key": "duplicate_session",
  "summary": "Prevent duplicate work from spawning more quota burn.",
  "audience": "operator",
  "trigger_states": ["running", "blocked", "failed"],
  "allowed_actions": ["escalate", "release"],
  "message_template": "This session appears to duplicate another worker or a recently completed attempt. Stop new changes, keep the current evidence intact, and wait for manager reconciliation before starting more work.",
  "operator_note_template": "Duplicate-session playbook selected for {{.ItemLabel}}.",
  "stop_conditions": ["duplicate ownership resolved"],
  "evidence": ["duplicate launch", "similar branch", "similar PR title", "same item already owned"]
}

{
  "key": "failed_session",
  "summary": "Stop active work and surface the smallest clean recovery path.",
  "audience": "operator",
  "trigger_states": ["failed"],
  "allowed_actions": ["escalate", "release"],
  "message_template": "This session appears failed or unrecoverable. Stop active work, preserve the current evidence, and report the smallest clean recovery step for {{.ItemLabel}}.",
  "operator_note_template": "Failed-session recovery selected for {{.ItemLabel}}.",
  "stop_conditions": ["operator intervenes", "session is terminalized"],
  "evidence": ["failed state", "stale lease", "missing remote activity"]
}

{
  "key": "local_only_session",
  "summary": "Handle rows that exist locally without a reachable remote worker.",
  "audience": "operator",
  "trigger_states": ["blocked", "failed"],
  "allowed_actions": ["reassign", "escalate", "release"],
  "message_template": "This session is local-only or missing its remote worker. Do not assume the work is progressing remotely. Reconcile ownership, then decide whether to reassign or release {{.ItemLabel}}.",
  "operator_note_template": "Local-only recovery selected for {{.ItemLabel}}.",
  "stop_conditions": ["remote owner restored", "item requeued", "item released"],
  "evidence": ["no remote account", "missing Jules session", "stale lease with no activity"]
}

{
  "key": "operator_paused_work",
  "summary": "Respect operator pauses and wait for an explicit resume.",
  "audience": "implementer",
  "trigger_states": ["paused"],
  "allowed_actions": ["noop", "escalate"],
  "message_template": "This session is paused by operator policy. Do not start new work or self-reassign. Wait for an explicit resume or a fresh operator instruction.",
  "operator_note_template": "Operator-paused work selected for {{.ItemLabel}}.",
  "stop_conditions": ["operator resumes", "operator changes the pause reason"],
  "evidence": ["operator pause reason", "manager pause reason", "sanity pause"]
}

{
  "key": "quiet_running_session",
  "summary": "Nudge a running worker that has gone quiet but is still expected to continue.",
  "audience": "implementer",
  "trigger_states": ["running", "starting"],
  "allowed_actions": ["nudge"],
  "message_template": "This session has been quiet for {{.QuietFor}}. Continue from the repository docs and current branch. If you are blocked, report the exact blocker and the smallest next step for {{.ItemLabel}}.",
  "operator_note_template": "Quiet running worker nudged for {{.ItemLabel}} after {{.QuietFor}}.",
  "stop_conditions": ["worker responds", "state changes"],
  "evidence": ["quiet_for >= nudge_after", "session still has an active owner"]
}

{
  "key": "remote_only_session",
  "summary": "Handle sessions that exist remotely but are missing locally.",
  "audience": "operator",
  "trigger_states": ["blocked", "failed"],
  "allowed_actions": ["escalate"],
  "message_template": "This session appears to exist remotely without a matching local owner. Stop assuming local state is authoritative and wait for manager reconciliation before taking any more action.",
  "operator_note_template": "Remote-only recovery selected for {{.SessionID}}.",
  "stop_conditions": ["local mirror reconciled"],
  "evidence": ["remote session missing local row", "mirror drift", "unmatched remote activity"]
}

{
  "key": "stale_lease",
  "summary": "Reassign or release work that has exceeded its lease.",
  "audience": "operator",
  "trigger_states": ["running", "paused", "blocked", "awaiting_clarification"],
  "allowed_actions": ["reassign", "escalate", "release"],
  "message_template": "This session's lease looks stale. Confirm whether the worker is still actively making progress. If not, reassign or release the smallest work item possible and leave a clear trace for the next worker.",
  "operator_note_template": "Stale-lease playbook selected for {{.ItemLabel}} after {{.QuietFor}}.",
  "stop_conditions": ["lease refreshed", "work requeued", "operator decides to hold"],
  "evidence": ["quiet_for beyond lease threshold", "lease expired", "worker not responding"]
}

You are the orchestrator for dev-manager.

Your job is to decide whether it is worth starting a fresh Jules session for a queued work item.
Be patient. Avoid duplicate sessions. Prefer waiting when an existing worker is already handling the same issue or pull request.
If the task is not clearly ready for a new worker, say so.
If the task is clearly ready, say so and give the smallest useful reason.

Prompt

You are the orchestrator for dev-manager.

Your job is to assess a Jules session that just reached a terminal state.
Use the repository docs, current codebase, and manager context to produce a short completion review.
Say whether the completion looks trustworthy and what the smallest next manager step should be.
Be concrete, calm, and brief.

You are an implementer. Write the code to solve the issue.

You are an orchestrator. Route and plan the work.

You are a reconciler. Tidy up, verify the final state, and close the loop.

You are a repairer. Fix the blocker or conflict that is preventing the work from progressing.

You are the clarification responder for dev-manager.

Your job is to answer Jules' question directly, briefly, and concretely.
Prefer repository docs, tracked issue/PR context, and the current codebase.
If the answer depends on live manager state, query the manager API yourself and turn that into a direct answer for Jules.
Never tell Jules to query localhost, the manager API, or any other local-only service.
If the docs do not cover the question, say exactly what is missing and the smallest next step.

You are a reviewer. Review the code changes.

You are a splitter. Break broad work into smaller, actionable slices and hand the next slice to the right worker.

Updated Prompt

Test Prompt

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 203, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 139, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 138, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 40, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 25, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 96, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 73, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 71, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 72, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 41, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 24, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 22, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 18, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 16, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 12, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 14, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 17, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 20, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 15, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 11, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 21, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 13, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 23, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"error": "signal: killed: OpenAI Codex v0.133.0\n--------\nworkdir: /home/stbmap/dev-manager\nmodel: gpt-5.4-mini\nprovider: openai\napproval: never\nsandbox: read-only\nreasoning effort: xhigh\nreasoning summaries: none\nsession id: 019e54a2-59ed-7d50-910c-a3283b714159\n--------\nuser\nYou are the clarification responder for dev-manager.\n\nYour job is to answer Jules' question directly, briefly, and concretely.\nPrefer repository docs, tracked issue/PR context, and the current codebase.\nIf the answer depends on live manager state, query the manager API yourself and turn that into a direct answer for Jules.\nNever tell Jules to query localhost, the manager API, or any other local-only service.\nIf the docs do not cover the question, say exactly what is missing and the smallest next step.\nManager endpoint base URL: http://10.128.0.2:8080/api/admin\nUse the published manager endpoints below when you need live context or to notify the manager.\nClarification questions are super-priority: answer the worker directly and do not defer the response behind unrelated work.\nIf you need to notify the manager about a session question, blocker, progress update, enhancement idea, or completion, use POST https://devman.stbm.app/api/agent/notify/8391091198507228080 with kind plus optional title, body, trace_id, source_type, and source_id.\nIf you need more live context, use these manager endpoints:\n- GET /questions\n- GET /sessions\n- GET /sessions/{id}\n- GET /jules-sessions\n- GET /jules-sessions/{id}/activities\n- GET /repos\n- GET /github-items\n- GET /roles\n- GET /settings\n- POST https://devman.stbm.app/api/agent/notify/8391091198507228080\nRecent durable memory:\n- [goal_plan] chain=goal-plan:Stbmap/dev-manager#294 repo=Stbmap/dev-manager title=\"feature: autonomy certification gate and unattended-mode promotion\" summary=\"Route issue #294 as one fat implementation task from merged main. The task should build the autonomy certification gate end to end rather than fragmenting policy, storage, and enforcement across separate issues.\" trace=0d173c86-143e-416b-ae35-6304748db9ba expires=2026-11-19T11:20:05Z\n- [goal_plan] chain=goal-plan:Stbmap/dev-manager#309 repo=Stbmap/dev-manager title=\"feature: runtime dependency health and provider fallback preflight\" summary=\"Route PR #309 as one Codex closeout task for Stbmap/dev-manager. Review the implementation against issue #285 and decide whether it is ready to merge or needs concrete fixes.\" trace=5e1dfc9e-f62b-4acb-81e7-c5a39a997813 expires=2026-11-19T10:45:43Z\n- [goal_plan] chain=goal-plan:Stbmap/dev-manager#308 repo=Stbmap/dev-manager title=\"feature: Jules session rescue ladder and artifact salvage\" summary=\"Route Stbmap/dev-manager PR #308 as a single Codex closeout task. Review the implementation against issue #289, check that rescue ladder behavior, cooldowns, debrief/salvage handling, prompt injection, and operator visibility are coherent, then run the relevant tests and either request fixes or close out the PR.\" trace=4ccc7a8a-df71-4f3a-b3c5-198506895b4a expires=2026-11-19T09:23:19Z\nUse these memories only when they are relevant to the current task; otherwise ignore them.\nWorking repo path: /home/stbmap/dev-manager\nAnswer format: return only the text that should be sent back to Jules, with no fences or preamble.\nClarification request:\n- session_id: 8391091198507228080\n- repo_full_name: Stbmap/dev-manager\n- item: session\n- title: feature: runtime dependency health and provider fallback preflight\n- state: awaiting_clarification\n- quiet_for: 1m\n- orchestrator_reason: session is waiting on clarification\n- recovery_playbook: awaiting_clarification\nwarning: Codex could not find bubblewrap on PATH. Install bubblewrap with your OS package manager. See the sandbox prerequisites: https://developers.openai.com/codex/concepts/sandboxing#prerequisites. Codex will use the bundled bubblewrap in the meantime.\nweb search: \nweb search: \nmcp: codex/list_mcp_resources started\nmcp: codex/list_mcp_resources (completed)\nweb search: \nweb search: \"runtime dependency health and provider fallback preflight\" ...\nweb search: \nweb search: site:github.com/Stbmap/dev-manager 309 \"runtime dependency health\" ...\nweb search: \nweb search: \"devman.stbm.app/api/admin/questions\" ...\nweb search: \nweb search: \nweb search: \nweb search: \nweb search: \nweb search: \"10.128.0.2:8080/api/admin/questions\" ...\nweb search: \nweb search: site:devman.stbm.app \"runtime dependency health and provider fallback preflight\" ...\nweb search: \nweb search: \"Stbmap/dev-manager\" ...\nweb search: \nweb search: \"/api/admin/questions\" ...\nweb search: \nweb search: \"runtime dependency health and provider fallback preflight\" devman ...\nweb search: \nweb search: \"http://10.128.0.2:8080/api/admin/questions\" ...\nweb search: \nweb search: \"Stbmap/dev-manager\" \"#285\" GitHub ...", "model": "gpt-5.4-mini", "action": "answer", "status": "failed", "provider": "codex", "trace_id": "4f381f2d-757f-4951-a5df-bbb3ab946f87", "item_type": "session", "latency_ms": 90005, "prompt_name": "responder", "repo_full_name": "Stbmap/dev-manager", "prompt_version_id": "56c10c5f-469b-4aa4-bbd6-34f4d5e89cd9", "prompt_version_number": 1}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 203, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 139, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 138, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 40, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 25, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 96, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 73, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 71, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 72, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 41, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 24, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 22, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 18, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 16, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 12, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 14, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"action": "answer_generation", "trace_id": "4f381f2d-757f-4951-a5df-bbb3ab946f87", "session_id": "8391091198507228080", "idempotency_key": "orchestrator-answer-generation:8391091198507228080:answer:4f381f2d-757f-4951-a5df-bbb3ab946f87:question:220cb14bfd6cfb77399ba660be503e691ad74d48374719123c258395ab10b98a"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 17, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 20, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 15, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 11, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 21, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 13, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 23, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 203, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}

{"reason": "no active session remains", "source": "stale issue sweep", "next_state": "closed", "item_number": 139, "labels_removed": ["blocked", "jules", "in-progress"], "previous_state": "closed", "repo_full_name": "Stbmap/stbmap"}