mirrors/hermes-agent
1
0
Fork 0
mirror of https://github.com/NousResearch/hermes-agent.git synced 2026-07-21 16:18:55 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 7

docs(kanban): clarify unblock status routing

Browse source
This commit is contained in:
Gille 2026-07-17 14:15:36 -06:00 • committed by Teknium
parent 9a7a43b5d6
commit f29c28d6d0
4 changed files with 10 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

5
hermes_cli/kanban.py
View file

@ -594,7 +594,10 @@ def build_parser(parent_subparsers: argparse._SubParsersAction) -> argparse.Argu
p_schedule.add_argument("--ids", nargs="+", default=None,
help="Additional task ids to schedule with the same reason (bulk mode)")
p_unblock = sub.add_parser("unblock", help="Return one or more blocked/scheduled tasks to ready")
p_unblock = sub.add_parser(
"unblock",
help="Return blocked/scheduled tasks to ready, or todo while parents remain open",
)
p_unblock.add_argument(
"--reason",
default=None,

7
tools/kanban_tools.py
View file

@ -1276,7 +1276,7 @@ def _maybe_auto_subscribe(conn: Any, task_id: str) -> bool:
def _handle_unblock(args: dict, **kw) -> str:
"""Transition a blocked task back to its actual post-unblock status."""
"""Transition a blocked task to ready, or todo while parents remain open."""
guard = _require_orchestrator_tool("kanban_unblock")
if guard:
return guard
@ -1875,7 +1875,8 @@ KANBAN_CREATE_SCHEMA = {
KANBAN_UNBLOCK_SCHEMA = {
"name": "kanban_unblock",
"description": (
"Move a blocked Kanban task back to ready. Orchestrator-only — only "
"Unblock a Kanban task. It moves to ready when all parents are done, "
"or todo while any parent remains open. Orchestrator-only — only "
"profiles with the kanban toolset can unblock routed work; "
"dispatcher-spawned task workers never see this tool."
),
@ -1884,7 +1885,7 @@ KANBAN_UNBLOCK_SCHEMA = {
"properties": {
"task_id": {
"type": "string",
"description": "Blocked task id to return to ready.",
"description": "Blocked task id to move to ready or parent-gated todo.",
},
"board": _board_schema_prop(),
},

2
website/docs/reference/tools-reference.md
View file

@ -130,7 +130,7 @@ Registered when the agent is either (a) spawned by the kanban dispatcher (`HERME
| `kanban_comment` | Add a comment to the task thread without changing its state — useful for surfacing intermediate findings. | `HERMES_KANBAN_TASK` or `kanban` toolset |
| `kanban_create` | Fan out child tasks from the current task. Used by orchestrators and follow-up-spawning workers. | `HERMES_KANBAN_TASK` or `kanban` toolset |
| `kanban_link` | Link tasks with a parent → child dependency edge. | `HERMES_KANBAN_TASK` or `kanban` toolset |
| `kanban_unblock` | Return a blocked task to `ready`. Orchestrator-only; hidden from dispatcher-spawned task workers. | profile with `kanban` toolset |
| `kanban_unblock` | Move a blocked task to `ready` when all parents are done, or `todo` while any parent remains open. Orchestrator-only; hidden from dispatcher-spawned task workers. | profile with `kanban` toolset |
## `project` toolset

2
website/docs/user-guide/features/kanban.md
View file

@ -279,7 +279,7 @@ hermes kanban block t_abc "need input" --ids t_def t_hij
| `kanban_comment` | Append a durable note to the task thread. | `task_id`, `body` |
| `kanban_create` | (Orchestrators) fan out into child tasks with an `assignee`, optional `parents`, `skills`, etc. | `title`, `assignee` |
| `kanban_link` | (Orchestrators) add a `parent_id → child_id` dependency edge after the fact. | `parent_id`, `child_id` |
| `kanban_unblock` | (Orchestrators) move a blocked task back to `ready`. | `task_id` |
| `kanban_unblock` | (Orchestrators) move a blocked task to `ready` when all parents are done, or `todo` while any parent remains open. | `task_id` |
A typical worker turn looks like: