omnifocus_mcp 1.0.2 → 1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +9 -0
  3. data/README.md +16 -3
  4. data/docs/superpowers/plans/2026-11-17-server-gap-fixes.md +192 -0
  5. data/lib/omnifocus_mcp/infrastructure/apple_script.rb +83 -19
  6. data/lib/omnifocus_mcp/infrastructure/script_runner.rb +5 -4
  7. data/lib/omnifocus_mcp/json_rpc_compat.rb +1 -2
  8. data/lib/omnifocus_mcp/logger.rb +1 -0
  9. data/lib/omnifocus_mcp/resources/base.rb +2 -37
  10. data/lib/omnifocus_mcp/resources/stats_resource.rb +1 -1
  11. data/lib/omnifocus_mcp/tools/database_stats.rb +3 -3
  12. data/lib/omnifocus_mcp/tools/definitions/add_omni_focus_task_tool.rb +5 -1
  13. data/lib/omnifocus_mcp/tools/definitions/add_project_tool.rb +4 -1
  14. data/lib/omnifocus_mcp/tools/definitions/batch_add_items_tool.rb +5 -3
  15. data/lib/omnifocus_mcp/tools/definitions/date_formatter.rb +6 -3
  16. data/lib/omnifocus_mcp/tools/definitions/edit_item_tool.rb +25 -6
  17. data/lib/omnifocus_mcp/tools/definitions/key_normalizer.rb +21 -1
  18. data/lib/omnifocus_mcp/tools/definitions/query_omnifocus_tool.rb +1 -2
  19. data/lib/omnifocus_mcp/tools/generators/add_omni_focus_task.rb +8 -13
  20. data/lib/omnifocus_mcp/tools/generators/add_project.rb +4 -6
  21. data/lib/omnifocus_mcp/tools/generators/database_stats.rb +1 -2
  22. data/lib/omnifocus_mcp/tools/generators/edit_item.rb +38 -53
  23. data/lib/omnifocus_mcp/tools/generators/note_edit.rb +108 -0
  24. data/lib/omnifocus_mcp/tools/generators/query_omnifocus.rb +11 -7
  25. data/lib/omnifocus_mcp/tools/generators/remove_item.rb +1 -1
  26. data/lib/omnifocus_mcp/tools/messages/add_omni_focus_task.rb +5 -3
  27. data/lib/omnifocus_mcp/tools/operations/add_omni_focus_task.rb +5 -3
  28. data/lib/omnifocus_mcp/tools/operations/add_project.rb +3 -3
  29. data/lib/omnifocus_mcp/tools/operations/batch_add_items/bulk_executor.rb +1 -1
  30. data/lib/omnifocus_mcp/tools/operations/batch_add_items.rb +4 -2
  31. data/lib/omnifocus_mcp/tools/operations/database_stats.rb +3 -3
  32. data/lib/omnifocus_mcp/tools/operations/edit_item.rb +3 -3
  33. data/lib/omnifocus_mcp/tools/operations/list_perspectives.rb +1 -1
  34. data/lib/omnifocus_mcp/tools/operations/remove_item.rb +3 -3
  35. data/lib/omnifocus_mcp/tools/params/mcp_boundary.rb +4 -2
  36. data/lib/omnifocus_mcp/tools/params.rb +2 -2
  37. data/lib/omnifocus_mcp/tools/presenters/query_results.rb +12 -8
  38. data/lib/omnifocus_mcp/utils/blank.rb +4 -0
  39. data/lib/omnifocus_mcp/utils/date_filter.rb +1 -2
  40. data/lib/omnifocus_mcp/version.rb +1 -1
  41. metadata +4 -2
@@ -38,7 +38,7 @@ module OmnifocusMcp
38
38
 
39
39
  def call(params)
40
40
  params = Params::McpBoundary.coerce(Params::AddProjectParams, params)
41
- generator.generate_apple_script(params).then { |script| run_script(script) }
41
+ generator.generate_apple_script(params).then { run_script(it) }
42
42
  rescue StandardError => e
43
43
  OmnifocusMcp.logger.warn("[add_project] Error: #{e}")
44
44
  OmnifocusMcp::Result.error(e.message || "Unknown error in add_project")
@@ -51,7 +51,7 @@ module OmnifocusMcp
51
51
  def run_script(script)
52
52
  stdout, stderr, status = script_runner.execute_applescript(script)
53
53
 
54
- OmnifocusMcp.logger.warn("[add_project] AppleScript stderr: #{stderr}") if stderr && !stderr.empty?
54
+ OmnifocusMcp.logger.warn("[add_project] AppleScript stderr: #{stderr}") if Utils::Blank.present?(stderr)
55
55
  return OmnifocusMcp::Result.error(applescript_run_failure(stderr:, status:)) unless status.success?
56
56
 
57
57
  parse_result(stdout)
@@ -66,7 +66,7 @@ module OmnifocusMcp
66
66
  def applescript_run_failure(stderr:, status:)
67
67
  exit_code = status.respond_to?(:exitstatus) ? status.exitstatus : status
68
68
  message = "osascript failed (exit #{exit_code})"
69
- message += ": #{stderr.strip}" unless stderr.nil? || stderr.empty?
69
+ message += ": #{stderr.strip}" unless Utils::Blank.blank?(stderr)
70
70
  message
71
71
  end
72
72
  end
@@ -57,7 +57,7 @@ module OmnifocusMcp
57
57
  private
58
58
 
59
59
  def log_stderr(stderr)
60
- return if stderr.nil? || stderr.empty?
60
+ return if Utils::Blank.blank?(stderr)
61
61
 
62
62
  OmnifocusMcp.logger.warn("[batch_add_items] AppleScript stderr: #{stderr}")
63
63
  end
@@ -74,8 +74,10 @@ module OmnifocusMcp
74
74
 
75
75
  def coerce_item(item)
76
76
  case item
77
- when Params::BatchAddItemParams then item
78
- when Hash then Params::BatchAddItemParams.from_hash(item)
77
+ when Params::BatchAddItemParams
78
+ item
79
+ when Hash
80
+ Params::BatchAddItemParams.from_hash(item)
79
81
  else raise ArgumentError, "expected BatchAddItemParams or Hash, got #{item.class}"
80
82
  end
81
83
  end
@@ -9,8 +9,8 @@ module OmnifocusMcp
9
9
  module Operations
10
10
  class DatabaseStats
11
11
  class << self
12
- def get_database_stats(script_runner: Infrastructure::ScriptRunner)
13
- new(script_runner:).get_database_stats
12
+ def database_stats(script_runner: Infrastructure::ScriptRunner)
13
+ new(script_runner:).database_stats
14
14
  end
15
15
 
16
16
  def get_changes_since(since, script_runner: Infrastructure::ScriptRunner)
@@ -23,7 +23,7 @@ module OmnifocusMcp
23
23
  @generator = generator
24
24
  end
25
25
 
26
- def get_database_stats
26
+ def database_stats
27
27
  script_payload_result(script_runner.execute_omnifocus_source(generator.stats_script))
28
28
  end
29
29
 
@@ -36,7 +36,7 @@ module OmnifocusMcp
36
36
 
37
37
  def call(params)
38
38
  params = Params::McpBoundary.coerce(Params::EditItemParams, params)
39
- generator.generate_apple_script(params).then { |script| run_script(script) }
39
+ generator.generate_apple_script(params).then { run_script(it) }
40
40
  rescue StandardError => e
41
41
  OmnifocusMcp.logger.warn("[edit_item] Error: #{e}")
42
42
  OmnifocusMcp::Result.error(e.message || "Unknown error in edit_item")
@@ -49,7 +49,7 @@ module OmnifocusMcp
49
49
  def run_script(script)
50
50
  stdout, stderr, status = script_runner.execute_applescript(script)
51
51
 
52
- OmnifocusMcp.logger.warn("[edit_item] AppleScript stderr: #{stderr}") if stderr && !stderr.empty?
52
+ OmnifocusMcp.logger.warn("[edit_item] AppleScript stderr: #{stderr}") if Utils::Blank.present?(stderr)
53
53
  return OmnifocusMcp::Result.error(applescript_run_failure(stderr:, status:)) unless status.success?
54
54
 
55
55
  parse_result(stdout)
@@ -70,7 +70,7 @@ module OmnifocusMcp
70
70
  def applescript_run_failure(stderr:, status:)
71
71
  exit_code = status.respond_to?(:exitstatus) ? status.exitstatus : status
72
72
  message = "osascript failed (exit #{exit_code})"
73
- message += ": #{stderr.strip}" unless stderr.nil? || stderr.empty?
73
+ message += ": #{stderr.strip}" unless Utils::Blank.blank?(stderr)
74
74
  message
75
75
  end
76
76
  end
@@ -11,7 +11,7 @@ module OmnifocusMcp
11
11
  class ListPerspectives
12
12
  class << self
13
13
  def call(params = nil, script_runner: Infrastructure::ScriptRunner, **kwargs)
14
- merge_params(params, kwargs).then { |params| new(script_runner:).call(params) }
14
+ merge_params(params, kwargs).then { new(script_runner:).call(it) }
15
15
  end
16
16
 
17
17
  def classify_response(response:, include_built_in:, include_custom:)
@@ -38,7 +38,7 @@ module OmnifocusMcp
38
38
 
39
39
  def call(params)
40
40
  params = Params::McpBoundary.coerce(Params::RemoveItemParams, params)
41
- generator.generate_apple_script(params).then { |script| run_script(script) }
41
+ generator.generate_apple_script(params).then { run_script(it) }
42
42
  rescue StandardError => e
43
43
  OmnifocusMcp.logger.warn("[remove_item] Error: #{e}")
44
44
  OmnifocusMcp::Result.error(e.message || "Unknown error in remove_item")
@@ -51,7 +51,7 @@ module OmnifocusMcp
51
51
  def run_script(script)
52
52
  stdout, stderr, status = script_runner.execute_applescript(script)
53
53
 
54
- OmnifocusMcp.logger.warn("[remove_item] AppleScript stderr: #{stderr}") if stderr && !stderr.empty?
54
+ OmnifocusMcp.logger.warn("[remove_item] AppleScript stderr: #{stderr}") if Utils::Blank.present?(stderr)
55
55
  return OmnifocusMcp::Result.error(applescript_run_failure(stderr:, status:)) unless status.success?
56
56
 
57
57
  parse_result(stdout)
@@ -66,7 +66,7 @@ module OmnifocusMcp
66
66
  def applescript_run_failure(stderr:, status:)
67
67
  exit_code = status.respond_to?(:exitstatus) ? status.exitstatus : status
68
68
  message = "osascript failed (exit #{exit_code})"
69
- message += ": #{stderr.strip}" unless stderr.nil? || stderr.empty?
69
+ message += ": #{stderr.strip}" unless Utils::Blank.blank?(stderr)
70
70
  message
71
71
  end
72
72
  end
@@ -29,8 +29,10 @@ module OmnifocusMcp
29
29
  # Accept a param struct or a snake_case Hash (e.g. specs, script helpers).
30
30
  def coerce(klass, value)
31
31
  case value
32
- when klass then value
33
- when Hash then klass.from_hash(value)
32
+ when klass
33
+ value
34
+ when Hash
35
+ klass.from_hash(value)
34
36
  else raise ArgumentError, "expected #{klass.name}, got #{value.class}"
35
37
  end
36
38
  end
@@ -29,9 +29,9 @@ module OmnifocusMcp
29
29
  :new_due_date, :new_defer_date, :new_planned_date, :new_flagged,
30
30
  :new_estimated_minutes, :new_status, :add_tags, :remove_tags,
31
31
  :replace_tags, :new_project_name, :new_sequential, :new_folder_name,
32
- :new_project_status
32
+ :new_project_status, :append_note, :note_replacements
33
33
  ) do
34
- def self.from_mcp(args) = McpBoundary.build(self, args)
34
+ def self.from_mcp(args) = McpBoundary.build(self, args, deep: true)
35
35
  def self.from_hash(hash) = McpBoundary.from_hash(self, hash)
36
36
  end
37
37
 
@@ -11,7 +11,7 @@ module OmnifocusMcp
11
11
  # Exposes `format_tasks`, `format_projects`, `format_folders`,
12
12
  # `format_query_results`, `format_filters`. Used by
13
13
  # {Definitions::QueryOmnifocusTool} to build the user-facing text reply.
14
- # rubocop:disable Metrics
14
+ # rubocop:disable-next Metrics
15
15
  module QueryResults
16
16
  class << self
17
17
  def format_query_results(items:, entity:, filters: nil)
@@ -22,9 +22,12 @@ module OmnifocusMcp
22
22
  output << "Filters applied: #{format_filters(filters)}\n\n" if filters && !filters.empty?
23
23
 
24
24
  output << case entity.to_s
25
- when "tasks" then format_tasks(items)
26
- when "projects" then format_projects(items)
27
- when "folders" then format_folders(items)
25
+ when "tasks"
26
+ format_tasks(items)
27
+ when "projects"
28
+ format_projects(items)
29
+ when "folders"
30
+ format_folders(items)
28
31
  else "Unsupported entity: #{entity}"
29
32
  end
30
33
 
@@ -108,9 +111,7 @@ module OmnifocusMcp
108
111
  parts << "[rule: #{t["repetitionRule"]}]" if t["repetitionRule"]
109
112
  parts << "[parent: #{t["parentId"]}]" if t["parentId"]
110
113
 
111
- if t["hasChildren"] && t["childIds"] && !t["childIds"].empty?
112
- parts << "[children: #{t["childIds"].join(", ")}]"
113
- end
114
+ parts << "[children: #{t["childIds"].join(", ")}]" if lists_children?(t)
114
115
 
115
116
  append_date(parts, label: "created", value: t["creationDate"])
116
117
  append_date(parts, label: "modified", value: t["modificationDate"])
@@ -177,9 +178,12 @@ module OmnifocusMcp
177
178
  formatted = Utils::IsoDate.to_date_only(value)
178
179
  parts << "[#{label}: #{formatted}]" if formatted
179
180
  end
181
+
182
+ def lists_children?(task)
183
+ task["hasChildren"] && task["childIds"] && !task["childIds"].empty?
184
+ end
180
185
  end
181
186
  end
182
- # rubocop:enable Metrics
183
187
  end
184
188
  end
185
189
  end
@@ -21,6 +21,10 @@ module OmnifocusMcp
21
21
 
22
22
  values.all? { |v| v.to_s.empty? }
23
23
  end
24
+
25
+ def present?(value)
26
+ !blank?(value)
27
+ end
24
28
  end
25
29
  end
26
30
  end
@@ -26,8 +26,7 @@ module OmnifocusMcp
26
26
  # pinned reference date in tests.
27
27
  class << self
28
28
  def parse(input, today: Date.today)
29
- return input if input.is_a?(Numeric)
30
- return input if input.is_a?(Symbol)
29
+ return input if input.is_a?(Numeric) || input.is_a?(Symbol)
31
30
 
32
31
  raise_invalid!(input) unless input.is_a?(String) && !input.empty?
33
32
 
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module OmnifocusMcp
4
- VERSION = "1.0.2"
4
+ VERSION = "1.1"
5
5
  VERSION_ARGS = %w[--version -v version].freeze
6
6
  end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: omnifocus_mcp
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.0.2
4
+ version: '1.1'
5
5
  platform: ruby
6
6
  authors:
7
7
  - Henry Maddocks
@@ -39,6 +39,7 @@ files:
39
39
  - README.md
40
40
  - Rakefile
41
41
  - bin/omnifocus-mcp
42
+ - docs/superpowers/plans/2026-11-17-server-gap-fixes.md
42
43
  - lib/omnifocus_mcp.rb
43
44
  - lib/omnifocus_mcp/cli.rb
44
45
  - lib/omnifocus_mcp/config.rb
@@ -82,6 +83,7 @@ files:
82
83
  - lib/omnifocus_mcp/tools/generators/edit_item.rb
83
84
  - lib/omnifocus_mcp/tools/generators/list_perspectives.rb
84
85
  - lib/omnifocus_mcp/tools/generators/list_tags.rb
86
+ - lib/omnifocus_mcp/tools/generators/note_edit.rb
85
87
  - lib/omnifocus_mcp/tools/generators/perspective_view.rb
86
88
  - lib/omnifocus_mcp/tools/generators/query_omnifocus.rb
87
89
  - lib/omnifocus_mcp/tools/generators/query_omnifocus_debug.rb
@@ -155,7 +157,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
155
157
  - !ruby/object:Gem::Version
156
158
  version: '0'
157
159
  requirements: []
158
- rubygems_version: 4.0.12
160
+ rubygems_version: 4.0.20
159
161
  specification_version: 4
160
162
  summary: MCP server bridging LLM clients to OmniFocus on macOS.
161
163
  test_files: []