Class: Pikuri::Tasks::Completed

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

Overview

The task_completed tool: mark the item whose content exactly matches as completed. Same shape and rationale as InProgress — the status is baked into the tool name to remove the enum-typo failure mode small models hit on “completed” / “complete” / “done”.

Returns the rendered current list via List#render on success, or “Error: no such task: ‘<content>’” when the content does not match.

Constant Summary collapse

DESCRIPTION =

Returns:

  • (String) 
<<~DESC
  Mark a task as `completed` once the work — including any required verification — is actually done.

  Usage:
  - Pass the exact `content` string the task was created with.
  - Do NOT mark `completed` based on intent; mark it only after the underlying work is verified.
  - If the work is partially done or blocked, leave the task `in_progress` and add a follow-up via `task_create`.
  - 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:) ⇒ Completed

Parameters:



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

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

Class Method Details

.execute(list:, content:) ⇒ String

Parameters:

  • list (List)
  • content (String)

Returns:

  • (String) 


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

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