Class: Pikuri::Tasks::InProgress

Inherits:
Pikuri::Tool
  • Object
show all
Defined in:
lib/pikuri/tasks/in_progress.rb

Overview

The task_in_progress tool: mark the item whose content exactly matches as in_progress. The status name is baked into the tool name rather than passed as a parameter — that takes one degree of freedom away from the LLM (no “in-progress” vs “in_progress” vs “inprogress” typos) at the cost of one extra tool class.

Returns the rendered current list via List#render on success, or “Error: no such task: ‘<content>’” when the content does not match — the LLM can read the returned list to find the closest match and re-call.

Constant Summary collapse

DESCRIPTION =

Returns:

  • (String) 
<<~DESC
  Mark a task as `in_progress` immediately before you start working on it.

  Usage:
  - Pass the exact `content` string the task was created with — content doubles as identifier; spelling and capitalization must match.
  - Keep exactly one task `in_progress` at a time. Finish (or revert) the current one before starting another.
  - On `Error: no such task: ...` the call did nothing — read the returned list in any subsequent tool's output to pick the right name.
  - On success the full current list is returned for you to read back.
DESC

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(list:) ⇒ InProgress

Parameters:



30
31
32
33
34
35
36
37
38
39
40
41
42
43
 
# File 'lib/pikuri/tasks/in_progress.rb', line 30

def initialize(list:)
  super(
    name: 'task_in_progress',
    description: DESCRIPTION,
    parameters: Pikuri::Tool::Parameters.build { |p|
      p.required_string :content,
                        'Exact content of the existing task to mark as ' \
                        'in_progress, e.g. "Add dark mode toggle".'
    },
    execute: lambda { |content:|
      InProgress.execute(list: list, content: content)
    }
  )
end

Class Method Details

.execute(list:, content:) ⇒ String

Parameters:

  • list (List)
  • content (String)

Returns:

  • (String) 


48
49
50
51
52
53
 
# File 'lib/pikuri/tasks/in_progress.rb', line 48

def self.execute(list:, content:)
  list.set_status(content: content, status: 'in_progress')
  list.render
rescue ItemNotFound
  "Error: no such task: '#{content}'"
end