omnifocus_mcp 1.0.1 → 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 (49) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +22 -1
  3. data/README.md +17 -13
  4. data/bin/omnifocus-mcp +0 -1
  5. data/docs/superpowers/plans/2026-11-17-server-gap-fixes.md +192 -0
  6. data/lib/omnifocus_mcp/infrastructure/apple_script.rb +83 -19
  7. data/lib/omnifocus_mcp/infrastructure/script_runner.rb +6 -8
  8. data/lib/omnifocus_mcp/json_rpc_compat.rb +1 -2
  9. data/lib/omnifocus_mcp/logger.rb +1 -0
  10. data/lib/omnifocus_mcp/resources/base.rb +2 -37
  11. data/lib/omnifocus_mcp/resources/stats_resource.rb +1 -1
  12. data/lib/omnifocus_mcp/tools/database_stats.rb +3 -157
  13. data/lib/omnifocus_mcp/tools/definitions/{add_omnifocus_task_tool.rb → add_omni_focus_task_tool.rb} +8 -4
  14. data/lib/omnifocus_mcp/tools/definitions/add_project_tool.rb +4 -1
  15. data/lib/omnifocus_mcp/tools/definitions/batch_add_items_tool.rb +5 -3
  16. data/lib/omnifocus_mcp/tools/definitions/date_formatter.rb +8 -7
  17. data/lib/omnifocus_mcp/tools/definitions/edit_item_tool.rb +25 -6
  18. data/lib/omnifocus_mcp/tools/definitions/key_normalizer.rb +21 -1
  19. data/lib/omnifocus_mcp/tools/definitions/query_omnifocus_tool.rb +1 -2
  20. data/lib/omnifocus_mcp/tools/generators/{add_omnifocus_task.rb → add_omni_focus_task.rb} +8 -13
  21. data/lib/omnifocus_mcp/tools/generators/add_project.rb +4 -6
  22. data/lib/omnifocus_mcp/tools/generators/database_stats.rb +133 -3
  23. data/lib/omnifocus_mcp/tools/generators/edit_item.rb +39 -56
  24. data/lib/omnifocus_mcp/tools/generators/note_edit.rb +108 -0
  25. data/lib/omnifocus_mcp/tools/generators/query_omnifocus.rb +32 -26
  26. data/lib/omnifocus_mcp/tools/generators/remove_item.rb +1 -1
  27. data/lib/omnifocus_mcp/tools/messages/{add_omnifocus_task.rb → add_omni_focus_task.rb} +5 -3
  28. data/lib/omnifocus_mcp/tools/operations/{add_omnifocus_task.rb → add_omni_focus_task.rb} +6 -4
  29. data/lib/omnifocus_mcp/tools/operations/add_project.rb +3 -3
  30. data/lib/omnifocus_mcp/tools/operations/batch_add_items/bulk_executor.rb +2 -2
  31. data/lib/omnifocus_mcp/tools/operations/batch_add_items/planner.rb +1 -0
  32. data/lib/omnifocus_mcp/tools/operations/batch_add_items.rb +6 -4
  33. data/lib/omnifocus_mcp/tools/operations/batch_remove_items.rb +4 -2
  34. data/lib/omnifocus_mcp/tools/operations/database_stats.rb +3 -3
  35. data/lib/omnifocus_mcp/tools/operations/edit_item.rb +3 -3
  36. data/lib/omnifocus_mcp/tools/operations/list_perspectives.rb +1 -1
  37. data/lib/omnifocus_mcp/tools/operations/remove_item.rb +3 -3
  38. data/lib/omnifocus_mcp/tools/params/mcp_boundary.rb +4 -2
  39. data/lib/omnifocus_mcp/tools/params.rb +2 -2
  40. data/lib/omnifocus_mcp/tools/presenters/query_results.rb +12 -6
  41. data/lib/omnifocus_mcp/utils/blank.rb +4 -0
  42. data/lib/omnifocus_mcp/utils/date_filter.rb +1 -2
  43. data/lib/omnifocus_mcp/version.rb +1 -1
  44. data/lib/omnifocus_mcp.rb +6 -7
  45. metadata +8 -10
  46. data/lib/omnifocus_mcp/tools/batch_report.rb +0 -9
  47. data/lib/omnifocus_mcp/tools/generators/.keep +0 -1
  48. data/lib/omnifocus_mcp/tools/query_omnifocus_formatter.rb +0 -9
  49. data/lib/omnifocus_mcp/utils/date_formatting.rb +0 -9
@@ -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,6 +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-next Metrics
14
15
  module QueryResults
15
16
  class << self
16
17
  def format_query_results(items:, entity:, filters: nil)
@@ -21,9 +22,12 @@ module OmnifocusMcp
21
22
  output << "Filters applied: #{format_filters(filters)}\n\n" if filters && !filters.empty?
22
23
 
23
24
  output << case entity.to_s
24
- when "tasks" then format_tasks(items)
25
- when "projects" then format_projects(items)
26
- 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)
27
31
  else "Unsupported entity: #{entity}"
28
32
  end
29
33
 
@@ -107,9 +111,7 @@ module OmnifocusMcp
107
111
  parts << "[rule: #{t["repetitionRule"]}]" if t["repetitionRule"]
108
112
  parts << "[parent: #{t["parentId"]}]" if t["parentId"]
109
113
 
110
- if t["hasChildren"] && t["childIds"] && !t["childIds"].empty?
111
- parts << "[children: #{t["childIds"].join(", ")}]"
112
- end
114
+ parts << "[children: #{t["childIds"].join(", ")}]" if lists_children?(t)
113
115
 
114
116
  append_date(parts, label: "created", value: t["creationDate"])
115
117
  append_date(parts, label: "modified", value: t["modificationDate"])
@@ -176,6 +178,10 @@ module OmnifocusMcp
176
178
  formatted = Utils::IsoDate.to_date_only(value)
177
179
  parts << "[#{label}: #{formatted}]" if formatted
178
180
  end
181
+
182
+ def lists_children?(task)
183
+ task["hasChildren"] && task["childIds"] && !task["childIds"].empty?
184
+ end
179
185
  end
180
186
  end
181
187
  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.1"
4
+ VERSION = "1.1"
5
5
  VERSION_ARGS = %w[--version -v version].freeze
6
6
  end
data/lib/omnifocus_mcp.rb CHANGED
@@ -22,7 +22,6 @@ require_relative "omnifocus_mcp/utils/apple_script_envelope"
22
22
  require_relative "omnifocus_mcp/utils/apple_script_helpers"
23
23
  require_relative "omnifocus_mcp/utils/blank"
24
24
  require_relative "omnifocus_mcp/utils/date_filter"
25
- require_relative "omnifocus_mcp/utils/date_formatting"
26
25
  require_relative "omnifocus_mcp/utils/iso_date"
27
26
  require_relative "omnifocus_mcp/utils/script_execution"
28
27
 
@@ -39,13 +38,13 @@ require_relative "omnifocus_mcp/tools/generators/query_omnifocus"
39
38
  require_relative "omnifocus_mcp/tools/generators/query_omnifocus_debug"
40
39
  require_relative "omnifocus_mcp/tools/generators/database_stats"
41
40
  require_relative "omnifocus_mcp/tools/generators/add_project"
42
- require_relative "omnifocus_mcp/tools/generators/add_omnifocus_task"
41
+ require_relative "omnifocus_mcp/tools/generators/add_omni_focus_task"
43
42
  require_relative "omnifocus_mcp/tools/generators/edit_item"
44
43
  require_relative "omnifocus_mcp/tools/generators/remove_item"
45
44
  require_relative "omnifocus_mcp/tools/operations/query_omnifocus"
46
45
  require_relative "omnifocus_mcp/tools/operations/query_omnifocus_debug"
47
46
  require_relative "omnifocus_mcp/tools/operations/database_stats"
48
- require_relative "omnifocus_mcp/tools/operations/add_omnifocus_task"
47
+ require_relative "omnifocus_mcp/tools/operations/add_omni_focus_task"
49
48
  require_relative "omnifocus_mcp/tools/operations/add_project"
50
49
  require_relative "omnifocus_mcp/tools/operations/batch_add_items"
51
50
  require_relative "omnifocus_mcp/tools/operations/batch_remove_items"
@@ -61,16 +60,16 @@ require_relative "omnifocus_mcp/tools/presenters/list_perspectives"
61
60
  require_relative "omnifocus_mcp/tools/presenters/list_tags"
62
61
  require_relative "omnifocus_mcp/tools/presenters/perspective_view"
63
62
  require_relative "omnifocus_mcp/tools/presenters/query_reply"
64
- require_relative "omnifocus_mcp/tools/batch_report"
63
+
65
64
  require_relative "omnifocus_mcp/tools/database_stats"
66
65
  require_relative "omnifocus_mcp/tools/presenters/query_results"
67
- require_relative "omnifocus_mcp/tools/query_omnifocus_formatter"
66
+
68
67
  require_relative "omnifocus_mcp/tools/query_statuses"
69
68
  require_relative "omnifocus_mcp/tools/definitions/date_formatter"
70
69
  require_relative "omnifocus_mcp/tools/definitions/key_normalizer"
71
70
  require_relative "omnifocus_mcp/tools/definitions/mcp_envelope"
72
71
  require_relative "omnifocus_mcp/tools/definitions/operation_factory"
73
- require_relative "omnifocus_mcp/tools/messages/add_omnifocus_task"
72
+ require_relative "omnifocus_mcp/tools/messages/add_omni_focus_task"
74
73
  require_relative "omnifocus_mcp/tools/messages/add_project"
75
74
  require_relative "omnifocus_mcp/tools/messages/batch_remove_items"
76
75
  require_relative "omnifocus_mcp/tools/messages/edit_item"
@@ -78,7 +77,7 @@ require_relative "omnifocus_mcp/tools/messages/list_tools"
78
77
  require_relative "omnifocus_mcp/tools/messages/remove_item"
79
78
 
80
79
  # Tool definitions wrap primitives for MCP exposure.
81
- require_relative "omnifocus_mcp/tools/definitions/add_omnifocus_task_tool"
80
+ require_relative "omnifocus_mcp/tools/definitions/add_omni_focus_task_tool"
82
81
  require_relative "omnifocus_mcp/tools/definitions/add_project_tool"
83
82
  require_relative "omnifocus_mcp/tools/definitions/batch_add_items_tool"
84
83
  require_relative "omnifocus_mcp/tools/definitions/batch_remove_items_tool"
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.1
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
@@ -60,9 +61,8 @@ files:
60
61
  - lib/omnifocus_mcp/resources/stats_resource.rb
61
62
  - lib/omnifocus_mcp/resources/today_resource.rb
62
63
  - lib/omnifocus_mcp/result.rb
63
- - lib/omnifocus_mcp/tools/batch_report.rb
64
64
  - lib/omnifocus_mcp/tools/database_stats.rb
65
- - lib/omnifocus_mcp/tools/definitions/add_omnifocus_task_tool.rb
65
+ - lib/omnifocus_mcp/tools/definitions/add_omni_focus_task_tool.rb
66
66
  - lib/omnifocus_mcp/tools/definitions/add_project_tool.rb
67
67
  - lib/omnifocus_mcp/tools/definitions/batch_add_items_tool.rb
68
68
  - lib/omnifocus_mcp/tools/definitions/batch_remove_items_tool.rb
@@ -77,26 +77,26 @@ files:
77
77
  - lib/omnifocus_mcp/tools/definitions/query_omnifocus_tool.rb
78
78
  - lib/omnifocus_mcp/tools/definitions/remove_item_tool.rb
79
79
  - lib/omnifocus_mcp/tools/generators.rb
80
- - lib/omnifocus_mcp/tools/generators/.keep
81
- - lib/omnifocus_mcp/tools/generators/add_omnifocus_task.rb
80
+ - lib/omnifocus_mcp/tools/generators/add_omni_focus_task.rb
82
81
  - lib/omnifocus_mcp/tools/generators/add_project.rb
83
82
  - lib/omnifocus_mcp/tools/generators/database_stats.rb
84
83
  - lib/omnifocus_mcp/tools/generators/edit_item.rb
85
84
  - lib/omnifocus_mcp/tools/generators/list_perspectives.rb
86
85
  - lib/omnifocus_mcp/tools/generators/list_tags.rb
86
+ - lib/omnifocus_mcp/tools/generators/note_edit.rb
87
87
  - lib/omnifocus_mcp/tools/generators/perspective_view.rb
88
88
  - lib/omnifocus_mcp/tools/generators/query_omnifocus.rb
89
89
  - lib/omnifocus_mcp/tools/generators/query_omnifocus_debug.rb
90
90
  - lib/omnifocus_mcp/tools/generators/remove_item.rb
91
91
  - lib/omnifocus_mcp/tools/messages.rb
92
- - lib/omnifocus_mcp/tools/messages/add_omnifocus_task.rb
92
+ - lib/omnifocus_mcp/tools/messages/add_omni_focus_task.rb
93
93
  - lib/omnifocus_mcp/tools/messages/add_project.rb
94
94
  - lib/omnifocus_mcp/tools/messages/batch_remove_items.rb
95
95
  - lib/omnifocus_mcp/tools/messages/edit_item.rb
96
96
  - lib/omnifocus_mcp/tools/messages/list_tools.rb
97
97
  - lib/omnifocus_mcp/tools/messages/remove_item.rb
98
98
  - lib/omnifocus_mcp/tools/operations.rb
99
- - lib/omnifocus_mcp/tools/operations/add_omnifocus_task.rb
99
+ - lib/omnifocus_mcp/tools/operations/add_omni_focus_task.rb
100
100
  - lib/omnifocus_mcp/tools/operations/add_project.rb
101
101
  - lib/omnifocus_mcp/tools/operations/batch_add_items.rb
102
102
  - lib/omnifocus_mcp/tools/operations/batch_add_items/batch_item.rb
@@ -122,14 +122,12 @@ files:
122
122
  - lib/omnifocus_mcp/tools/presenters/perspective_view.rb
123
123
  - lib/omnifocus_mcp/tools/presenters/query_reply.rb
124
124
  - lib/omnifocus_mcp/tools/presenters/query_results.rb
125
- - lib/omnifocus_mcp/tools/query_omnifocus_formatter.rb
126
125
  - lib/omnifocus_mcp/tools/query_statuses.rb
127
126
  - lib/omnifocus_mcp/utils/apple_script.rb
128
127
  - lib/omnifocus_mcp/utils/apple_script_envelope.rb
129
128
  - lib/omnifocus_mcp/utils/apple_script_helpers.rb
130
129
  - lib/omnifocus_mcp/utils/blank.rb
131
130
  - lib/omnifocus_mcp/utils/date_filter.rb
132
- - lib/omnifocus_mcp/utils/date_formatting.rb
133
131
  - lib/omnifocus_mcp/utils/iso_date.rb
134
132
  - lib/omnifocus_mcp/utils/omnifocus_scripts/getPerspectiveView.js
135
133
  - lib/omnifocus_mcp/utils/omnifocus_scripts/listPerspectives.js
@@ -159,7 +157,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
159
157
  - !ruby/object:Gem::Version
160
158
  version: '0'
161
159
  requirements: []
162
- rubygems_version: 4.0.12
160
+ rubygems_version: 4.0.20
163
161
  specification_version: 4
164
162
  summary: MCP server bridging LLM clients to OmniFocus on macOS.
165
163
  test_files: []
@@ -1,9 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- require_relative "presenters/batch_report"
4
-
5
- module OmnifocusMcp
6
- module Tools
7
- BatchReport = Presenters::BatchReport
8
- end
9
- end
@@ -1 +0,0 @@
1
-
@@ -1,9 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- require_relative "presenters/query_results"
4
-
5
- module OmnifocusMcp
6
- module Tools
7
- QueryOmnifocusFormatter = Presenters::QueryResults
8
- end
9
- end
@@ -1,9 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- require_relative "../infrastructure/apple_script_date_builder"
4
-
5
- module OmnifocusMcp
6
- module Utils
7
- DateFormatting = Infrastructure::AppleScriptDateBuilder
8
- end
9
- end