mindroot.coreplugins.check_list package¶
Submodules¶
mindroot.coreplugins.check_list.mod module¶
checklist helper for an LLM-agent system ———————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————— Purpose ——-
Parse a Markdown checklist section where each subtask is written as a task-list line
Store parsed tasks + cursor in context.data[‘checklist’]
Support nested subtasks within parent task bodies
Runtime helpers for managing both top-level and nested subtasks
complete_subtask and other commands live at module level so the agent can call them as tools. No third-party deps—only Python’s re module.
- async mindroot.coreplugins.check_list.mod.clear_subtask(subtask_id=None, context=None)[source]¶
Mark a subtask as incomplete (not done). Now supports both top-level and nested subtasks.
Parameters: - subtask_id: Optional. The subtask to clear, specified by:
The exact subtask label text (top-level or nested)
Omit to clear the current subtask
Example: { “clear_subtask”: {} } # Clear current subtask { “clear_subtask”: { “subtask_id”: “Review documents” } } # Clear top-level by label { “clear_subtask”: { “subtask_id”: “USP” } } # Clear nested subtask
- async mindroot.coreplugins.check_list.mod.complete_subtask(subtask_id=None, context=None)[source]¶
Mark a subtask complete and return a Markdown status message. Now supports both top-level and nested subtasks.
Parameters: - subtask_id: Optional. The subtask to complete, specified by:
The exact subtask label text (top-level or nested)
Omit to complete the current subtask
Example: { “complete_subtask”: {} } # Complete current subtask { “complete_subtask”: { “subtask_id”: “Review documents” } } # Complete by label { “complete_subtask”: { “subtask_id”: “USP” } } # Complete nested subtask
- async mindroot.coreplugins.check_list.mod.delegate_subtask(subtask_id, details: str, agent=None, context=None)[source]¶
Delegate a subtask to an agent, automatically passing the subtask body as instructions, along with any details you add. Now supports both top-level and nested subtasks.
IMPORTANT: You can only delegate ONE task a time. You must wait for this task delegation to complete before issuing more delegate_subtask commands.
If agent is not specified, the current agent name will be used for the subtask.
IMPORTANT: Subtask ID may only contain alphanumerics; all other special characters are invalid.
Example: { “delegate_subtask”: { “subtask_id”: “Research”,
“details”: “Session data in /data/sess_1234/” }}
- { “delegate_subtask”: { “subtask_id”: “USP”,
“details”: “Focus on unique selling proposition analysis” }}
Note that you do not need to repeat the text of the subtask item from the checklist in your details.
- mindroot.coreplugins.check_list.mod.extract_checklist_section(md: str)[source]¶
Extract checklist items from the entire markdown text.
No longer requires a specific ‘Checklist’ heading - processes the entire text and extracts only top-level checklist items, leaving nested ones intact.
- async mindroot.coreplugins.check_list.mod.get_checklist_status(context=None)[source]¶
Show the full status of the checklist.
Example: { “get_checklist_status”: {} }
- async mindroot.coreplugins.check_list.mod.get_parsed_subtasks(subtask_id=None, context=None)[source]¶
Return parsed subtasks with their name/id and body for verification. Now supports getting nested subtasks from within parent tasks.
Parameters: - subtask_id: Optional. If provided, parse subtasks from the body of this specific subtask.
If omitted, returns all top-level subtasks from the main checklist.
Returns a list of dictionaries with: - label: The subtask name/label - body: The subtask body content - done: Whether the subtask is marked as complete - index: The 0-based index of the subtask
Example: { “get_parsed_subtasks”: {} } # Get all top-level subtasks { “get_parsed_subtasks”: { “subtask_id”: “Research phase” } } # Get nested subtasks from “Research phase” { “get_parsed_subtasks”: { “subtask_id”: “Core” } } # Get nested subtasks from “Core”
- async mindroot.coreplugins.check_list.mod.goto_subtask(subtask_id, context=None)[source]¶
Move to a specific subtask without changing its completion status. Now supports both top-level and nested subtasks.
Parameters: - subtask_id: Required. The subtask to navigate to, specified by:
The exact subtask label text (top-level or nested)
Example: { “goto_subtask”: { “subtask_id”: “Data analysis” } } # Go to top-level task { “goto_subtask”: { “subtask_id”: “USP” } } # Go to nested task