Skip to content
Back to top
View this page

# 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)

  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)

  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.create_checklist(tasks, title=None, replace=True, context=None)

  Create a new checklist dynamically from a list of task descriptions.

  Parameters: - tasks: Required. List of task description strings - title: Optional. Title for the checklist (for display purposes) - replace: Optional. Whether to replace existing checklist (default: True)

  Example: { “create_checklist”: {

  > “tasks”: [

  >   “Research the topic”, “Create outline”, “Write first draft”, “Review and edit”

  > ], “title”: “Article Writing Process”

  }}

async mindroot.coreplugins.check_list.mod.delegate_subtask(subtask_id, details: str, agent=None, context=None)

  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)

  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)

  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)

  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)

  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

mindroot.coreplugins.check_list.mod.load_checklist(md: str, ctx)

  Parse markdown and reset cursor to first unchecked subtask.

async mindroot.coreplugins.check_list.mod.load_checklist_from_instructions(md: str, context=None)

  Load checklist from instructions.

  Processes the entire text and extracts top-level checklist items.

## Module contents